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COMMANDS' 


ACCESS 

8-12” 

EFFECT 

8-4 

MACHINE 

7-39 

RUN 

8-35" 

ALGOLS 

60481600 

ELSE 

6-17 

MAP 

60429800 

SATISFY 

60429800 

ALTER 

8-42" 

ELSEIF 

6-18 

MERGE 

60484800 

SAVE 

10-46 

APEX 

76070000 

ENDIF 

6-18.1 

MFL 

7-39 

SCOPY 

9-51 

APL 

60454000 

ENDW 

6-19 

MFLINK 

10-22 

SCREEN 

8-7” 

APPEND 

10-7 

ENQUIRE 

7-13 

MFQUEUE 

9-31 

SECHOR 

9-54 

APPSW 

8-18 

ENTER 

7-21 

MODE 

6-22 

Secure Login 

8-36” 

ASCII 

8-2” 

ERRMSG 

7-22 

MODIFY 

14-5; 

SET 

6-25 

ASSIGN 

9-2; 12-5 

EVICT 

9-22 


60450100 

SETASL 

7-59 

ATTACH 

10-8 

EXECUTE 

8-13”; 

MOVE 

8-48” 

SETCORE 

7-60 

AUTO 

8-3 


60429800 

NEW 

9-34 

SETFAL 

9-55 

BASIC 

8-12; 

EXIT 

6-19 

NOEXIT 

6-24 

SETFS 

9-56 


19983900 

EXPLAIN 

8-20.1” 

NORERUN 

7-40 

SETJAL 

7-61 

BATCH 

8-13” 

FCOPY 

9-23 

NORMAL 

8-7 

SETJOB 

7-62 

BEGIN 

4-41 

FILE 

60495700 

NOSORT 

8-29” 

SETJSL 

7-63 

BKSP 

9-4 

FORTRAN 

8-14” 

NOTE 

7-40 

SETPFAC 

10-48 

BKSPRU 

9.4.1 

FSE 

14-2; 

NULL 

8-15 

SETPFAL 

10-49 

BLANK 

12-9 


60460420 

OFFSW 

7-41 

SETPR 

7-64 

BLOCK 

7-2 

FTN 

60497800 

OLD 

10-28 

SETTL 

7-64 

BRIEF 

8-4" 

FTNIS 

8-15" 

ONEXIT 

6-24 

SHELL 

7-66 

BYE 

8-19 

FTN5 

60481300 

ONSW 

7-42 

SHOW 

8-36 

CATALOG 

15-5 

FTP 

60000214 

OPLEDIT 

14-8; 

SKIP 

6-30 

CATLIST 

10-10 

F45 

10-20.1; 


60450100 

SKIPEI 

9-56 

CFO 

7-3 


60483000 

OUT 

9-35 

SKIPF 

9-57 

CHANGE 

10-15 

GET 

10-21 

OVWRITE 

9-35 

SKIPFB 

9-57 

CHARGE 

7-4 

GO 

7-22 

PACK 

9-36 

SKI PR 

9-58 

CHVAL 

7-5 

GOODBYE 

8-21 

PACKNAM 

10-29 

SLOAD 

60429800 

CKP 

13-1 

GPSS 

84003900 

PASCAL 

60497700 

SORT 

9-58 

CLASS 

7-7 

GTR 

15-11 

PASSWOR 

7-42 

SORT5 

60484800 

CLEAR 

9-5 

HELLO 

8-21 

PAUSE 

7-44 

STIME 

7-67 

C0B0L5 

60497100 

HELL07 

8-22 

PBC 

11-9 

SUBMIT 

7-68 

COMMENT 

7-9 

HELP 

8-26” 

PDU 

14-10 

SWITCH 

7-73 

COMMON 

10-16 

HELPME 

8-26” 

PERMIT 

10-30 

Status (ctE) 

8-17” 

COMPASS 

60492600 

HTIME 

7-22.1 

PLI 

60388100 

Status (ctS) 

8-17” 

COPY 

9-5 

IF (or IFE) 

6-20 

PRIMARY 

9-37 

TAFLOG 

60459500 

COPYBF 

9-11 

ITEMIZE 

15-14 

PROFILE 

14-11 

TCOPY 

9-59 

COPYBR 

9-12 

Job 

7-23 

PROTECT 

7-44 

TDU 

8-8.1 

COPYCF 

9-13 

KEY 

8-5 

PURGALL 

10-31 

TDUMP 

9-62 

COPYCR 

9-15 

KRONREF 

14-4 

PURGE 

10-32.1 

TEXT 

8-37 

COPYEI 

9-16 

LABEL 

12-11 

QGET 

7-45 

TIMEOUT 

8-9 

COPYL 

15-7 

LBC 

11-8 

QUEUE7 

7-46 

TRMDEF 

8-9 

COPYLM 

15-7 

LDI 

7-26 

RBR 

11-9 

ULIB 

15-34 

COPYSBF 

9-17 

LDSET 

60429800 

READ 

8-49” 

UNLOAD 

9-64 

COPYX 

9-18 

LENGTH 

7-27 

RECLAIM 

10-34 

UNLOCK 

9-65 

CSET 

8-4” 

LIB 

8-26” 

RECOVER 

8-30 

UPDATE 

14-14 

CTIME 

7-10 

LIBEDIT 

15-17 

REDO 

7-50 

UPROC 

7-73” 

DAYFILB 

7-10 

LIBGEN 

15-32 

REDUCE 

60429800 

USECPU 

7-74 

DEBUG 

60481400 

LIBLOAD 

60429800 

RENAME 

9-37 

USER 

7-74" 

DEFINE 

10-17 

LIBRARY 

15-43; 

REPLACE 

10-45 

VERIFY 

9-65 

DELETE 

8-44” 


60429800 

REQUEST 

9-38; 

VFYLIB 

15-35 

Detach (ctD) 

8-16” 

LIBTASK 

60459500 


12-21 

VSN 

12-25 

DIAL 

8-20.1” 

LIMITS 

7-28 

RERUN 

7-50.1 

WBR 

11-10 

DISPLAY 

6-16.4 

LINE 

8-6.1 

RESEQ 

9-40 

WHATJSN 

8-37" 

DMB 

11-1 

LIST 

8-28, 46” 

RESOURC 

7-50.1 

WHILE 

6-31 

DMD 

11-5 

LIST80 

9-26 

RESTART 

13-2 

WRITE 

8-51” 

DMDECS 

11-6 

LISTLB 

12-19 

RETURN 

9-42 

WRITEF 

9-68 

DMP 

11-6.1 

LISTLID 

7-36 

REVERT 

4-51 

WRITEN 

8-52” 

DMPECS 

11-7 

LOAD 

60429800 

REWIND 

9-43 

WRITER 

9-68 

DOCMENT 

9-20 

LOG 

11-8 

RFL 

7-57 

X 

8-38 

DROP 

7-12.1 

LOCK 

9-26 

ROLLOUT 

7-58 

XEDIT 

14-18; 

DROPDS 

10-20 

LOGIN 

8-28 

ROUTE 

9-44 


60455730 

DUP 

EDIT 

8-45” 

14-1 

LOGOUT 

L072 

8- 29 

9- 27 

RTIME 

7-58 

XMODEM 

8-38; P-1 


Reference to a page number indicates the command is described in this manual; a manual pulibcation number 
means the command is described in that manual. Manual titles are listed in the preface. Refer to the NOS 
Version 2 Analysis Handbook for a list of system analyst-oriented commands. 

"you can enter this command only from an Interactive job. 
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PROCEDURE DIRECTIVES 


Directive 

Paqe 

.CC 

4-33 

.CORRECT 

4-23 

• DATA 

4-34.2 

• ELSE 

4-38 

•ELSEIF 

4-38.1 

• ENDW 

4-40.1 

.ENDHELP 

4-24 

.ENDIF 

4-39 

.ENTER 

4-24 

.EOF (or .EOP) 

4-38 

.EOR (or .EOS) 

4-39 

.EX 

4-39 

.EXPAND 

4-33 

.Fn 

4-24.1 

.F7 

4-24.2 

.HELP 

4-25 

. IC 

4-34 

.IF (or .IFE) 

4-40 

.NOCLR 

4-31 

.NOTE 

4-31 

.PAGE 

4-32 

. PROC 

4-11, L- 

. PROMPT 

4-32 

.SET 

4-34 

•WHILE 

4-40.1 

• * 

4-40.2 
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PREFACE 


This manual describes the CONTROL DATA Network Operating System (NOS) Version 2. NOS can 
operate on the following coni)uter systems: 

CONTROL DATA CYBER 180 Computer Systems 

Models 810, 830, 835, 840, 845, 850, 855, 860, 870, 960, 970, 990, 994, and 995 
CONTROL DATA CYBER 170 Conputer Systems 

Models 171, 172, 173, 174, 175, 176, 720, 730, 740, 750, 760, 815, 825, 835, 845, 855, 
865, and 875 

CONTROL DATA CYBER 70 Con^juter Systems 
Models 71, 72, 73 and 74 

CONTROL DATA 6000 Computer Systems 


AUDIENCE 

Volume 1, Introduction to Interactive Usage (60459660), is written for the novice. 

Volume 2, Guide to System Usage (60459670), is written for the applications or systems 
prograimmer who is unfauniliar with NOS. 

Volume 3, System Commands (60459680), is written for all NOS users. 

Volume 4, Program Interface (60459690), is written for the experienced COMPASS applications 
programmer or systems programmer. 

The reader of each volume should have a knowledge of the material contained in the previous 
volumes. 


ORGANIZATION 


The NOS reference set describes the external features of NOS 2. This reference set comprises 
four separate volumes. 

Voliane 1, Introduction to Interactive Usage, shows a user at an interactive terminal how to 
enter, mm, and correct programs, and how to create, retrieve, and maintain periticment files. 
Other topics covered include physical terminal connection, and login/logout procedures. 

Volume 2, Guide to System Usage, describes the general concepts of NOS and some of the 
utilities used with NOS. Topics included are job processing, file concepts, procedures, 
magnetic tape processing. Modify, and file loading. This volume is a learning tool and does 
not contain comprehensive descriptions of all NOS commands. 


60459680 P 


3 




Volume 3, System Commands, describes the system commands that form the user interface to NOS. 

Voliime 4, Program Interface, describes the COMPASS program interface to NOS. Detailed 
descriptions of function processors and macros available to COMPASS user programs are 
included. 


SUBMITTING COMMENTS 


If you have comments concerning this manual, mail your comments to: 

Control Data 

Documentation Services ARH219 
4201 Lexington Avenue N. 

St. Paul, MN 55126-6198 

Please indicate whether you would like a response. 

If you have access to SOLVER, the Control Data online facility for reporting problems, you can 
use it to submit comments about this manual. Use NS2 as the product identifier, and include 
the name and publication number of the manual. 

If you have questions about the packaging and/or distribution of printed manuals, write to: 
Control Data 

Literature and Distribution Services ARHLDS 
4201 Lexington Avenue N. 

St. Paul, MN 55126-6198 

You can call (612) 415-4478 or FAX your inquiry to (612) 415-4359. 


CENTRAL SOFTWARE SUPPORT HOTLINE 

Control Data's Central Software Support maintains a hotline to assist you if you have trouble 
using our products. If you need help beyond that provided in the documentation, or find the 
product does not perform as described, call one of the following numbers and a support analyst 
will work with you. 

From the USA and Canada: 1-800-345-6628 

From other countries 1-612-415-4272 
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CONVENTIONS 


A vertical bar in the margin indicates a technical change. Other conventions are described in 
the following sections. 

REFERENCES TO OTHER MANUALS IN THE NOS REFERENCE SET 

Throughout this manual, references to Volumes 1, 2, and 4 of the NOS Reference Set are in the 
form: refer to section n, (volume namie) . If a volxmie number is not specified, the reference 
is to Voliime 3. 


180-CLASS MAINFRAMES 

Some of the CYBER 170 Computer Systems sheire many of the functional and architectural 
attributes of the CYBER 180 Computer Systems. Specifically, CYBER 170 Models 815, 825, 835, 
845, and 855 fall into this category. It is sometimes convenient to refer to the CYBER 180 
models and these CYBER 170 models collectively. This manual uses the term 180-class 
mainframes to refer to this collection. 


EXTENDED MEMORY 

Extended memory for the CYBER 180-claes machines auid models 865 and 875 is unified extended 
memory (DEM) and may also include extended core storage (ECS), extended semiconductor memory 
(ESH) , or STORNET. Extended memory for model 176 is large central memory extended (LCME) and 
may include ECS, ESM, or STORNET. Extended memory for all other NOS ccmputer systems is 
either ECS, ESM, or STORNET. 

In this manual, ECS refers to ECS, ESM, and STORNET. Extended memory refers to all forms of 
extended memory unless otherwise noted. However, when referencing extended memory in the 
context of an ECS multimainframe cooplex, distributive data path (DDR), or low-speed port 
(LSP) access, UEM cuad IiCME are excluded. ECS, ESM, and STORNET are the only forms of extended 
memory that can be shared in ECS multimainframe conplex and ceui be accessed by a DDR or LSR. 
For CYBER 180-class machines, only tJEM may be accessed directly frcan CRU programs as extended 
field length; similarly, on the model 176, only LCME may be accessed directly from CPO 
programs. The other forms of extended memory are supported only as mass storage devices on 
these machines. 

Programming information for the various forms of extended memory can be found in the COMPASS 
Version 3 Reference Manual and in the appropriate conputer system hardware reference manual. 


60459680 P 


5 




CYBER 70 COMPUTER SYSTEMS REFERENCES 

References to the CYBER 70 Ccat 5 )uter Systems pertain only to models 71, 72, 73, and 74. 


CONTROL STATEMENT 

The manxials of many NOS products use the term control statement instead of the term command. 
This manual uses the term command almost exclusively. You can consider the two synonymous. 


EXAMPLES 

The following conventions apply to exanples that appear in this manual: 

• Exan 5 >les of actual terminal sessions that appear in this manual were produced on a 
display terminal in NORMAL character mode unless otherwise specified. Uppercase 
characters represent terminal output; lowercase characters represent user input 
unless otherwise noted. (However, user input that is displayed within the text of 
this manual is shown in uppercase characters). The vertical spacing in exanples 
does not necessarily coincide with the spacing that appears on your terminal. 

• Program exanples are written either in FORTRAN 5 or BASIC 3 (hereafter referred to 
as just BASIC). 

• This manual uses ccanmas to delimit ccsnmand parameters and periods to terminate 
commands. For clarity, however, commands that appear in text use an opening 
parenthesis for their initial delimiter and a closing parenthesis for their 
terminator. 


COMMAND FORMAT 

Interpret uppercase characters within command formats literally. Lowercase characters are 
variables and are described immediately following the line that shows the command format. 


SPECIAL KEYBOARD ENTRIES 

This manual uses special notation to represent certain keyboard entries: 

• @ denotes the message transmission key on the keyboard. Depending on the terminal 
class, this key may be the RETURN, CR, CARRIAGE RETURN, NEW LINE, SEND, or ETX key. 
For some terminal classes, the RETURN or NEW LINE key also denotes a message 
terminator, but the message is kept in the terminal buffer until the corresponding 
SEND or ETX key is pressed, sending all messages in the buffer to lAF. i^pendix K 
supplies more information. lAF and the network respond to the @ by positioning the 
carriage to the first character position on the next line. 

• -^“designates the backspace character. 

• notation CTRL/x directs you to press the control key (which is labeled CTRL, 
CNTL, CNTRL, or similar characters) on the terminal and, while holding this key 
down, press the key specified by x. For exan^le, CTRL/H means press and hold the 
control key while you press the H key. 
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RELATED PUBLICATIONS 


You may want to consult the following Control Data manuals for information related to topics 
discussed in this manual. For your convenience, these manuals are listed by category: CDCNET 
manuals, hardware manuals, NOS 2 manuals, and optional product manuals. 

If you need a brief description of the NOS product commands and their parameters, refer to the 
NOS Version 2 i^lications Programmer's Instant (60459370). In addition, brief descriptions 
of all NOS operating system and NOS product set manuals are available in the NOS System 
Information manual. You access this online manual by logging into NOS auid entering the 
EXPLAIN conmand. 

Control Data manuals are available through Control Data sales offices or through Literature 
and Distribution Services: 

Control Data 

Literature and Distribution Services ARHLDS 
4201 Lexington Avenue N. 

St. Paul, MN 55126-6198 


CDCNET MANUALS 

The following manuals describe the Control Data Distributed Communications Network (CDCNET). 

Publication 

Control Data Publication Number 


CDCNET Access Guidet 

CDCNETA 

CDCNET Batch Device User Guide 

60463863 

CDCNET Conceptual Overview 

60461540 

CDCNET Configuration Guide 

60461550 

CDCNET Terminal Interface Usage 

60463850 

CDCNET TCP/IP Usage 

60000214 


tOnline manual only. Enter EXPLAIN,M=manual. 
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HARDWARE MANUALS 


The following manuals describe Control Data con^uter systems and related equipment. 


Control Data PiiVil i nation 


Publication 

Number 


CYBER 70 Model 71 Con^juter System Hardware Reference Hcinual 60453300 

CYBER 70 Model 72 Computer System Hardware Reference Manual '60347000 

CYBER 170 Con^juter Systems Models 171 through 175 
(Levels A, B, C) Model 176 (Level A, B, C) 

Hardware Reference Manual 60420000 

CYBER 170 Ccxt^juter Systems Models 720, 730, 740, 750, 760 

Model 176 (I,evel B/C) Hardware Reference Manual 60456100 

CYBER 170 CcMiputer Systems Models 815 auid 825 

Hardware Reference Hauiual 60469350 

CYBER 170 Con^uter Systems Models 835, 845, and 855 
CYBER 180 Ccmq)uter Systems 

Models 835, 840, 845, 850, 855, 860, 970, and 990 
CYBER 990E and 995B Computer Systems CYBER 170 State 


Hardware Reference Manual 60469290 

CYBER 170 Conputer Systems Models 835, 845, and 855 
CYBER 180 Con 5 )uter Systems Models 835, 845, and 855 

Hardware Operator's Guide 60458390 

CYBER 170 Conjjuter Systems Models 865 and 875 

Hardware Reference Manual 60458920 

CYBER 180 Models 810 and 830 Computer Systems 

Hardware Reference Manual 60469420 

CYBER 840A, 850A, 860A, and 870A Computer Systems 

Hardware Reference Manual 60463560 

5870 Printer User's Reference Manual 60462720 

5830 Disk Array Subsystem Configuration Guide 60000494 

5830 Disk Array Subsystem Controller Reference 60000551 

5830 Disk Array Subsystem Reference 60000552 


8 


60459680 P 



NOS 2 MANUALS 


The following meuiuals describe NOS 2. 

Control Data Publication 

Common Memory Manager Version 1 Reference Manual 

COMPASS Version 3 Reference Manual 

CYBER Iioader Version 1 Reference Manual 

CYBER Record Manager Advainced Access Methods Version 2 
Reference Manual 

CYBER Record Manager Basic Access Methods Version 1.5 
Reference Manual 

FORM Version 1 Reference Manual 

Modify Version 1 Reference Manual 

NOS Online Maintencurice Software Reference Manual 

NOS Version 2 Administration Handbook 

NOS Version 2 Analysis Handbook 

NOS Version 2 J^plications Programmer's Instant 

NOS Version 2 Diagnostic Index 

NOS Version 2 Full Screen Editor User's Guide 

NOS Version 2 Installation Handbook 

NOS Version 2 Operations Handbook 

NOS Version 2 Reference Set, Voltime 1 
Introduction to Interactive Usage 

NOS Version 2 Reference Set, Volume 2, Guide to System Osage 

NOS Version 2 Reference Set, Volume 4, Program Interface 

NOS Version 2 Screen Formatting Reference Manual 

NOS Version 2 Security Administrator's Handbook 

NOS Version 2 System Overview 

NOS Version 2 Systems Programmer's Instant 

SYMPL Version 1 Reference Manvial 


Publication 

Number 

60499200 

B0492600 

60429800 

60499300 

60495700 

60496200 

60450100 

60454200 

60459840 

60459300 

60459360 

60459390 

60460420 

60459320 

60459310 

60459660 

60459670 

60459690 

60460430 

60460410 

60459270 

60459370 

60496400 
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OPTIONAL PRODUCT MANUALS 


The following manuals describe optional products. 

Control Data Publication 


Publication 

Humber 


APEX IV Reference Manual 

APL Version 2 Reference Manual 

Automatically Programmed Tooling System 
(APT IV) Version 2 Reference Manual 

BASIC Version 3 Reference Manual 

COBOL Version 5 Reference Manual 

CYBER Database Control System 2 Database Administrator 
Reference Manual 

CYBER Datctbase Control System 2 Dateibase implication 
Programming Reference Manual 

CYBER Interactive Debug Version 1 Reference Manual 

Data Catalogue 2 Version 1 Reference Manual 

Data Catalogue 2 Version 2 Reference Manual 

DDL Version 3 Reference Manual, Volume 1 

DDL Version 3 Reference Manual, Volume 2 

DDL Version 3 Reference Mcinual, Volume 3 

FORTRAN DataBase Facility Version 1 Reference Manual 

FORTRAN Extended Version 4 Common Library 
Mathematical Routines Reference Manual 

FORTRAN Extended Version 4 Reference Manual 

FORTRAN Extended Version 4 to FORTRAN Version 5 Conversion 
Aids Program Version 1 Reference Manual 

FORTRAN Version 5 Common Library Mathematical Routines 
Reference Manual 

FORTRAN Version 5 Reference Manual 

General Purpose Simulation System V (GPSS) 

General Information Manual 


84002550 

'60454000 

17326900 

19983900 

60497100 

60485200 

60485300 

60481400 

60483200 

60483350 

60481900 

60482000 

60482100 

60482200 

60498200 

60497800 

60483000 

60483100 

60481300 

84003900 
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Optional Product Manuals (Continued) 

Control Data Publication 

Information Management Facility Version 1 
;^lication Programming Reference Manual 

Message Control System Version 1 Reference Manual 

NetworJc Access Method Version 1 

Host Application Programming Reference Mcuiual 

Network Access Method Version 1 

Network Definition Language Reference Manual 

Network Access Method Version 1/Communications Control 
Program Version 3 Terminal Interfaces Reference Manual 

NOS Version 2 Tape Management System (IMS) 

Site Operations Manual 

NOS Version 2 Tape Management System (TMS) 

Oser Reference Mcuiual 

Pascal Version 1.1 Reference Manual 

PERT/Time Version 2 Reference Manual 

Query Update Version 3 Reference Manual 

Remote Batch Facility Version 1 Reference Manual 

Remote Host Facility Access Method Reference Manual 

Remote Host Facility Usage 

Sort/Merge Version 5 Reference Mauiual 

TAP Version 1 Reference Manual 

TAF Version 1 User's Guide 

TAF/CRM Data Manager Version 1 Reference Manual 
TOTAL-CDC Version 2 Reference Manual 
Update Version 1 Reference Manual 
XEDIT Version 3 Reference Manual 
8-Bit Subroutines Version 1 Reference Manual 


Publication 

Number 


60484500 

60480300 

60499500 

60480000 

60480600 

60463350 

60463110 

60497700 

60456030 

60498300 

60499600 

60459990 

60460620 

60497500 

60459500 

60459520 

60459510 

76070300 

60449900 

60455730 

60495500 
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SYSTEM DESCRIPTION 


1 


NOS is capable of several concurrent processing modes. The following are the processing 
modes available. 

• Local batch. 

• Remote batch. 

• Transaction. 

• Interactive. 


The network processing modes (remote batch, transaction, and interactive) operate through 
the Network Access Method (NAM) communications software. These processing modes are 
implemented, respectively, by the following NAM applications: Remote Batch Facility (RBF), 
Transaction Facility (TAF), and Interactive Facility (lAF). 

The primary emphasis of this manual is Interactive and local batch processing. For the 
other processing modes, consult the appropriate manuals listed in the preface. 

NOS, like all operating systems, is the interface between you and the capabilities of system 
hardware components. The remainder of this section describes the hardware and software that 
make up a NOS-controlled computer system. In most cases, you need not understand the 
operation of system hardware or the internal operation of system software. This maTuiai 
describes these topics only as general background for understanding NOS commands. 


SYSTEM HARDWARE 

NOS can operate within the CYBER 180, CYBER 170, CYBER 70, and 6000 Computer Systems (refer 
to the preface for an exhaustive list of model numbers). The primary hardware components of 
each system are the following. 

• Central processor unit(s). 

• Central memory. 

• Extended memory (optional). 

• Peripheral processors. 

• Peripheral equipment. 


60459680 E 


1-1 



CENTRAL PROCESSOR UNIT 


The central processor unit (CPU) executes instructions and manipulates and stores data 
retrieved from central memory. The number and type of CPUs within a mainframe vary with the 
machine model. As a result, some models can execute additional instructions. These model 
differences do not affect applications written in higher level languages. 


CENTRAL MEMORY 

The primary functions of central memory (CM) are; 

• To buffer data to and from the peripheral processors. 

• To transfer instructions and data to and from the CPU. 


Job Field Length 

The job field length is the portion of central memory that is assigned to your job. Several 
jobs can reside in CM simultaneously. Each job is assigned a starting CM address (its 
reference address or RA) and is allocated an initial field length (the CM words in which the 
job resides and executes). The field length is adjusted during job execution as described 
in section 3. Figure 1-1 shows a job field length within CM. 

A reference to an address outside the job's field length range causes a hardware error 
condition and job termination. 

The maximum field length depends on the CM size and Installation parameters used to control 
memory usage. The system assigns the CPU to jobs requiring CPU activity. Rapid switching 
of CPU control between jobs enables them to execute concurrently. The exact amount of time 
allowed for each job depends on system activity and system parameter settings. Thus, the 
time required to complete a job may vary from run to run, although the actual CPU execution 
time is similar. 

When a job completes, aborts, or rolls out (that is, its execution is suspended), the field 
length is released, cleared, and made available to another job. 
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CENTRAL 

MEMORY 



FIELD 

LENGTH 

(FL) 


Figure 1-1. Central Memory Allocation 


Central Memory Resident 

The portion of CM reserved for system use is called central memory resident (CMR), It 
contains system tables, directories, and the CM portion of the system monitor (CPUMTR). 


EXTENDED MEMORY 

Extended memory for NOS computer systems (refer to preface), can be used for the following 
purposes. 

• As a directly accessible memory device via FORTRAN or COMPASS statements for 
extended memory data storage and retrieval (refer to the FORTRAN 5 Reference Manual 
or appendix D of Volume 4, Program Interface). 

• As storage for frequently accessed small files (refer to ASSIGN command in section 7 
and Permanent File Commands in section 9). 

• As an alternate system device for storing copies of frequently used routines. 

• As a link between mainframes in a multimainframe configuration.t 

You must be authorized to use extended memory (refer to LIMITS command in section 7). 


tModel 176 cannot use extended memory to link mainframes. 
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PERIPHERAL PROCESSORS 


The peripheral processors (PPs) process communications between CM and individual peripheral 
devices. They also perform system control functions. A peripheral processor can; 

• Read and write CM. 

• Read and write extended memory indirectly via CM or directly via the distributive 
data path (DDP) or low-speed port (LSP). 

• Transfer data to and from peripheral devices through the data channels. 

NOS supports a variety of PP configurations. Each computer system supports a different 
range of configurations. To determine the configurations supported by your computer system 
consult the appropriate system hardware reference manual listed in the preface. 

PERIPHERAL EQUIPMENT 

Peripheral equipment varies among installations but usually includes card readers and 
punches, line printers, mass storage devices, and magnetic tape units. NOS supports the 
following equipment models. 

• 405 Card Reader 

• 415 Card Punch 

• 533/536 Printer 

• 537 Printer 

• 580-12, 580-16, and 580-20 Line Printers 

• 585 Printer 

• 5870 Non-Impact Printer 

• 834/836 Disk Storage Subsystem 

• 844-21 Disk Storage Subsystem 

• 844-41/44 Disk Storage Subsystems 

• 885-11/12 Disk Storage Subsystems 

• 885-42 Disk Storage Subsystem 

• 887 Disk Storage Subsystem 

• 895-1/2 Disk Storage Subsystem 

• 819 Disk Storage Subsystem 

• 5830 Disk Array Subsystem (DAS) 

• 9853 Disk Storage Subsystem 

• 7990 Mass Storage Extended Subsystem (MSE) 

• 639, 667, 669, 677, 679, and 698 Magnetic Tape Units 


1-4 


60459680 N 




255x Network Processing Units 
26xx Device Interfaces 
380-170 Network Access Device 
6683 Satellite Coupler 


SYSTEM SOFTWARE 


Software executed within a computer system can be divided between software that is built 
into the system during system initialization and software that executes as jobs within the 
running system. Software present when the system begins running includes the operating 
system and products such as compilers, CYBER Loader, and CYBER Record Manager. 


USER PROGRAMS 

A user program is a group of CPU instructions that perform a certain task or calculate a 
result. A user program can be written in a language at any of three levels. 

• Compiler languages provide you with a language suited to your particular needs. The 
program statements are translated by the appropriate compiler (FORTRAN, COBOL, 

ALGOL, and so on), which generates assembler language or machine language 
instructions. Programs written in compiler languages may be machine-independent. 

• Assembler languages provide a one-to-one relationship between instructions and 
machine operation. Mnemonics are provided for each instruction. These languages 
are machine-dependent. Much of the NOS system is written in COMPASS, the assembler 
language of the CYBER 180, CYBER 170, CYBER 70, and 6000 Computer Systems. 

• Hardware instructions are interpreted directly by the computer. Each hardware 
instruction is a binary number. Most users are rarely concerned with instructions 
written at this level except when program debugging requires interpreting memory 
dumps. 


OPERATING SYSTEM 

NOS is a group of programs that supervise and coordinate the operation of system hardware 
and the execution of products and user programs. The following lists some of the functions 
of NOS. 


• Loading and scheduling of user progrcims. 

• Job validation and accounting. 

• Command translation. 

• File retrieval, manipulation, routing, and storage. 

• Job input and output. 

• Normal and abnormal job termination. 

• Memory dumps. 
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CYBER Loader 


CYBER Loader prepares programs for execution. Following your directions, it allocates 
memory for a program, loads the program modules into their appropriate locations, generates 
a load map, and initiates program execution. It can load subdivided programs for more 
efficient use of memory. Refer to the CYBER Loader Reference Manual for more information. 


CYBER Record Manager 

CYBER Record Manager (CRM) is the interface between program input/output (I/O) functions and 
NOS physical I/O functions. NOS commands do not use CRM. Some of the products that use CRM 
are COBOL 5, FORTRAN Extended 4, FORTRAN 5, Sort/Merge 5, PL/I (Programming Language I), and 
DMS-170. 

The functions of CRM are divided between the Basic Access Methods (BAM) and Advanced Access 
Methods (AAM). BAM handles sequential and word-addressable file organizations; AAM handles 
indexed sequential, direct access, and actual key file organizations. Refer to the 
appropriate CYBER Record Manager manual listed in the preface. 
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A file Is a collection of information addressable by name* All NOS data processing involves 
operations performed on files. Files can be differentiated by their name, structure, or 
type or by whether they are assigned to a job (NOS jobs are described in section 3). 


FILE NAMB 


A file name consists of unique string of seven or less alphanumeric characters. Although 
NOS allows file names that begin with a digit, many of its products (FORTRAN 5 and COBOL 5, 
for example) do not support such file names. Refer to the product reference manual listed 
in the preface for details. 


Examples; 

A A1 TAPE DUMP12 COMPILE 

NOS uses many internal scratch files. Most of these scratch files have names beginning with 
the letters ZZ or SCR. Avoid using a name starting with these letters for any of your files. 

The following file names are significant because they are associated with system-managed 
files that are assigned to your job. 

INPUT OUTPUT PUNCH PUNCHB P8 

Refer to the description of File Types for more information. 


RLE STRUCTURE 


A file consists of a well-defined set of data. Its physical representation varies markedly 
with the device upon which it resides. For instance, the physical structure of a file on 
magnetic tape is only remotely similar to its physical structure on disk. To facilitate the 
manipulation of file data by user and system programs, the system imposes a logical 
structure on a file that does not vary with device residence.t 

A logical file consists of a contiguous series of data (physically, the data is not always 
contiguous). A file always has a beginning of information and an end of information. It 
can be subdivided into a maximum of three levels. Figure 2-1 illustrates the structure of a 
file with one, two, and three levels of subdivisions, NOS and its products (refer to 
section 1) all use this basic structure for a logical file. 


tThere are differences in logical structure that depend on device residence, but these 
differences are of interest only to a COMPASS programmer. These differences are described 
in Volume 4, Program Interface. 
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NOS and some of its products do differ in both the levels of file subdivision they recognize 
and the names of the subdivisions. One of the most prominent of these products is CYBER 
Record Manager (CRM). It handles input and output for some widely used products like 
FORTRAN 5 and COBOL 5. The next two subsections contrast the treatment that NOS and CRM 
give a logical file. 


Beginning of 
Information 


End of 
Information 


Third-level Subdivision 


Data 


ccccccccccccccccccccccccccccccccccccccccccccc 


Second-level Subdivision 


c c c c c c c c 


c c c c c c c 


cccccccccccccccccccccccccccccc 


c c |c c c c|c c c c 


' First-level Subdivision 


cccccccccccccccccccccccccc 


c c c c c c c 


Figure 2-1. Logical Structure of Files 
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CYBER RECORD MANAGER FILE STRUCTURE 

CRM recognizes all three levels of file subdivision. It calls a first-level subdivision a 
partition, a second-level subdivision a section, and a third-level subdivision a record. 
Thro\igh CRM, you can specify a file organization, a blocking type, and a record type for 
your data. The file organization determines how records are accessed, the blocking type 
determines how CRM records are grouped on their storage media, and the record type defines 
the smallest unit of data CRM can retrieve. Refer to the CRM manuals listed in the preface 
for a detailed description. 


NOS HLE STRUCTURE 

NOS recognizes only two levels of file subdivision, the first and second levels. t NOS calls 
a first-level subdivision a file and a second-level subdivision a record. The record is the 
smallest recognizable unit for both CRM and NOS but the term does not always refer to the 
same subdivision for the two processors. Figure 2-2 illustrates the differences in 
terminology. 


file 

first-level 

second-level 

third-level 

processor 

subdivision 

subdivision 

subdivision 

NOS 

file 

record 


CRM 

partition 

section 

record 


Figure 2-2. NOS and CRM File Terminology 


Since NOS terms a first level subdivision a file, a NOS file can contain more than one 
logical file; if it does, it is called a multifile file. A multifile file begins at 
beginning-of-information (BOI) and ends at end-of-information (EOI). A file within a 
multifile file begins either at BOI or after the end-of-file (EOF) of the preceding file. 

It ends at its EOF. 

Each file consists of zero or more logical records of Information. A record is zero or more 
60-bit CM words. A record begins at the BOI, after an EOF, or after the end-of-record (EOR) 
of the preceding record. It ends at its EOR. The following is the structure of a 
single-record file. 

BOI data EOR EOF EOI 

or 

BOI data EOR EOI 

Most simple files, like text files, have one of these two formats. 


fThis is true for NOS commands but, at the program level, NOS does recognize third-level 
subdivisions. 
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The following is the structure of a multirecord, multifile file. 

BOI data EOR data EOR EOF data EOR data EOR EOF EOI 

The last EOF in a file may or may not be present depending upon the program used to create 
the file. 


PHYSICAL HIE STRUCTURE 

When NOS stores a file, it automatically converts the file to a structure that will conform 
to the physical characteristics of the storage medium. The logical file and record marks 
are converted to physical BOI, EOR, EOF, and EOI indicators. 

The basis of all physical file structures is the physical record unit (PRU), the minimum 
amount of data that can be read or written in a single device access. Table 2-1 lists the 
PRU size, and record and file mark indicators for each supported storage device. 
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Table 2-1. Physical File Structure On Different Devices 



RATOTd and File tlar}c Xndicaeors 


(Long block 
internal) 


PSS 1 or random 
address 1 of 
the disk (count¬ 
ing from O). 



512 Q1 words; 
ea^ PRQ in¬ 
cludes a 46-bit 


S12 CA words; 
ea^ PRD of 
less than 512 
words has a 
46-bit 
terminator. 


If labeled, tape 
mark following 
KDRl label. If 
unlabeled, load 
point. ttt 


Zf labeled, ta^e 
mark following 
KDRl label. If 
unlabeled, load 
point, ttt 


Maximum of SI2 Zf labeled, tape 
CM words; (refer mark following 
to BS parameter KDRl label. If 


on COPY cCBBiand 
in section 9 
and to appendix 
J in voliioe 4). 


Bo 

defined (refer 
to BS param¬ 
eter on COPY 
cownand in 
section 9 and 
to appendix J 
in volume 4}. 


Determined by 
C or FC param¬ 
eter on AS5IGB, 
LABEL, or 
REQDBST coomand. 


unlabeled, 
load point. ttt 


If labeled, tape 
mark following 
HDRl label. 

Zf \mlabeled. 
load point.ttt 


PRO of less 
than €4 words 
with a link to 
ths next PRO. 


Card with a 
7/6/9 punch 
in colimn 1. 
Remote Batch 
Facility 
(RBF)/KASP can 
also use /*SOR. 


On input, one 
nonnull line 
of data with 
BOR level 1. 


A PRO of less 
than S12 words 
with level 
number of 0. 


A PRO of less 
than 512 words 
with level 
nisnber between 
0 and iSo. 


End of each 
PRD. 


End of each 
PRD. 


Zero-length 
PRU (no data) 
with special 
link to next 
PRO. 


Cemd with 
6/7/9 punch 
in column 1.'^ 


On input, 
one null line 
of input. 


Zero-length 
PRD whose 
terminator 
contains a 
level number 
of 17fl. 


Zero-length 
PRD whose 
terminator 
contains a 
level number 
of 178. 


Zero-length 
PRD with no 
forward link. 


Card with 
6/7/8/9 punedi 
in coliunn 1. 
RBP/KASP can 
also use /*E0I. 



Tape mark,ttttt 



Tape mark fol¬ 
lowed by an 
EOFl label. 


Tape mark fol¬ 
lowed by an 
SOFl label. 


If labeled, a 
tape mark fol¬ 
lowed by an 
BOFl label. If 
xmlabeled, there 
is no SOI in¬ 
dicator. 


Zf labeled, a 
tape nark fol¬ 
lowed by an 
BOFl label. Zf 
unlabeled, there 
is no SOI in¬ 
dicator . 



4096 C31 words; If labeled, tape A PRU of less 


each PRD in¬ 
cludes a 60-bit 
prefix. 


mark following 
KDRl label. Zf 
unlabeled, load 
point, ttt 


than 4096 words 
with level 
nisiber of 0. 


Zero-length 
PRD whose 
terminator 


level number 
of 178- 


T^pe mark fol¬ 
lowed by an 
SOFl label. 


fPor more informatiOT. refer to i^endix F. 

ttThe 6/7/9 card is not recognised in a remote batch job. In an RBF j^ the end-o£-file marker is a card with a 7/6/9 
punch in colum 1 and a level number of 178 in coliams 2 and 3. RBF/HASP can also use a card with /*B0R in columns 1 
through 5 axid a level number of 178 in columns € and 7. 

ttt In the ease of multivolxane tape files. BOI is the KDRl label of the first vol\xme. In the case of an ABSZ multifile, 
BOZ is the HDRl label associated with the beginning of the multifile. 
ttttPor more information, refer to section 12 and appendix 6. 

tttttOn labeled ts^s, interchange etandards require that tape marks be used only to delimit tape label groups. 
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Card Files 


The physical file and record indicators in a card file are shown in figure 2-3 and listed in 
table 2-1. Although card decks do not have a defined PR0 size, a card is the minimum data 
unit. NOS Ceun read and punch cards in coded (Hollerith), binary, and absolute binary 
formats as described in appendix F. Coded cards are punched in 02S or 029 keypunch mode. 

The system uses the installation default keypimch mode (chosen by the installation) for 
reading cards unless a 26 or 29 is punched in columns 79 and 80 of a job, EOR, or EOF card, 
indicating that the subsequent cards are ptmched in that mode. NOS can punch up to 80 
characters on a coded card and up to 150 characters (15 CM words) on a binary card.t 



Mass Storage Files 

Mass storage files are stored on disk or extended memory. 

To use NOS, you do not need to know the physical structure of mass storage; you do need to 
know its logical structure, which contains the concepts of logical devices and logical 
tracks. A logical device is one or more physical disk units known to the system as a single 
device. A logical track is a file allocation ijnit determined by the device type. 


t Keypunch mode selection is not supported for jobs entered through a 200 User Teminal or 
similar remote batch terminal except for HASP. 
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Each permanent file on mass storage is accessed via a catalog track containing the penocuient 
file catalog of its owner. Indirect access files (refer to Permcuient Files) must reside on 
the same device as their catalog; direct access files may reside on euiother device. Space 
is allocated for mass storage files in units called reservation blocks. An indirect access 
file reservation block is always 64 words (one PRU). A direct access file reservation block 
is a logical track. The maximum size of your mass storage file is determined by your 
validation limits (refer to LIMITS Commctnd in section 6) . 


Magnetic Tape Files 

You may write information on magnetic tapes in either coded mode or binary mode. Coded mode 
operations involve data conversion from NOS-supported character sets to external character 
sets as shown in table 2-2. Coded mode is applicctble largely for S and L tape formats. 

Coded mode is not supported on cartridge (AT or CT) t^es. Binary mode operations copy 
files with no character set conversion and can be used for any tape format. 

The term coded mode should not be confused with coded line. A coded line is defined as a 
line of 160 characters or less, terminated by a zero byte. Similarly, coded euid binary mode 
should not be confused with coded and binary files. A coded file is a NOS system file coded 
in 6-bit display code, 6/12-bit display code, or 7-bit ASCII code. A binary file is simply 
a file containing binary information. Coded files can be copied in coded or binary mode; 
binary files can be copied only in binary mode. 

The only NOS commands reccmimended for coded mode operations are COPY, FCOPY, and TCOPY. Any 
of the copy commcuids can be used for binary mode copies. For CYBER Record Heuiager (CRM) 
files, the CM parameter on the FILE ccxnmand is used to select coded or binary mode. For 
FORTRAN programs, use the BUFFER 00T(n,l) statement to select binary mode 2 md the BUFFER 
onT(n,0) statement to select coded mode. For COBOL programs, use either the RECORDING MODE 
IS BINARY statement or the RECORDING MODE IS CODED statement. 

The representation of data in memory and on tape depends on the tape device type (seven- 
track, nine-track, or cartridge tape), the recording mode (binary or coded), euid the 
specification of the CV=cv parameter on the lABEL command. Table 2-2 shows how the data 
representation varies with these factors. 
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Tcible 2-2. Data Representation on Magnetic Tape 


Tape 

Device Type 

Binary Mode 

Coded Mode 


1. Odd parity. 

1. Odd parity. 

9-track (HT) 

2. Groups of four 6-bit 

characters in memory are 
written without conversion 
on three-frame units on tape. 

2. Bach 6-bit character in 
memory is translated into 
am 8-bit equivalent on tape. 
You can choose EBCDIC 
or ASCII by specifying 

CV=EB or CV=AS on a LABEL 

command. 


1. Odd parity. 

1. Even parity. 

7-track (MT) 

2. Each 6-bit character in 
memory is written without 
conversion. 

2. Each 6-bit character in 
memory is translated to 
its BCD equivalent on 
tape. The % character is 
lost in the translation. 

Cartridge 

1. Odd parity. 

Not supported, except for 

(CT or AT) 

2 . Groups of eight 6-bit 
characters in memory 
are written without 
conversion on three-frame 
units on tape. 

labels. Labels are written 
as odd parity with each 6-bit 
character in memory trans¬ 
lated into an 8-bit equiva¬ 
lent on tape. You can choose 
EBCDIC or ASCII by specifying 
CVsEB or CVsAS on a LABEL 

ccxnmand. 
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Tape Density 


You can select 200- (read only), 556-, or 800-character-per-inch (cpi) density for seven- 
track tapes; 800-, 1600-, or 6250-character-per-inch (cpi) density for nine-track tapes; or 
38000-character-per-inch (cpi) density for cartridge (CT or AT) tape, provided these 
densities are available with the site hardware. NOS automatically processes tape peurity 
errors and end-of-tape conditions imless you select other processing options (refer to 
Processing Options in section 12) . You can also control error processing by using the EO 
parameter on a FILE command. 


Tape Labels 

Tape labels identify and delimit tape volumes and tape files. Tape marks begin 6uid end most 
tape lobels. A tape mark is a special bit sequence written and recognized by a tape unit. 

NOS processes ANSI standard emd nonstandard labeled tapes. Nonstandard labeled tapes are 
those whose format or content do not conform to the ANSI standard described in appendix G. 
NOS skips to the first tape mark when reading a nonstandard labeled tape if the tape 
assignment statement specifies the LB=NS parameter (refer to section 12) . All information 
after the first tape mark is then handled as data. Any tape marks occurring after the first 
tape mark are heuidled as appropriate for the tape format (refer to table 2-1) . 


File set configurations (* means tape mark): 

Single file on single volume 

(A) (A) 



VOL1 

HDR1 

* 

File A data 

r 

EOF1 

* 

■ 

Single file on more than one volume 
(A) 

Volume 

1 

VOL1 

HDR1 

* 

File A data 

♦ 

EOV1 

* 

« 


(A) (A) 

Volume 

2 

VOL1 

HDR1 


File A data 

* 

EOF1 

* 

* 

More than one file on a single volume 

(A) (A) (B) (B) 


VOL1 

HDR1 

* 

File A data * EOF1 * HDR1 * File B data 


-1 

EOF! 

• 

« 


Volume 

1 


Volume 

2 


Volume 

3 


More than one file on more than One volume 

(A) (A) (B) 


VOL1 

HDR1 

« 

File A data 

* 

EOF! 

• 

HDR1 

« 

File B data 

« 

EOV1 

* 

« 

(B> 

VOL1 

HDR1 

« 

File B data ^ ^ 

■ 

EOV1 

• 



(B) 




(B) 


(C) 




(C) 



VOL1 

HDR1 

« 

File B data 

* 

EOF1 

* 

HDR1 

« 

File C data 

: 

EOF1 

: 



Figure 2-4. Use of ANSI Labels 
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ANSI Standard labels as defined by NOS are those that conform to the American National 
Standard Magnetic Tape Labels for Information Interchange X3.27-1969 standard. NOS can 
create or verify ANSI labels if the LABEL command assigns the ta^e file. LeJsel verification 
ensures that the correct volume has been mounted. ANSI labels separate multifile set files 
6u}d indicate if a file continues on another volume. 

The ANSI label EOF indicates end-of-information for a file within a file set. The use of 
ANSI labels to delimit files within file sets is illustrated in figure 2-4. 

An ANSI-labeled tape must have the following ladiels. Other optional labels are described in 
appendix G. 

Iiabel Location 

VOLl Beginning of volume . 

KDRl Beginning of information. If the file continues on to another volume, the 

HDRl label is repeated. It must follow the VOLl label and precede the 
continuation of the file information. 

EOFl End of information. 

EOVl End of volume (required only if the file continues on another volume) . 

J^pendix G gives the tape label formats. 
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Tape Data Formats 


HOS can read and write data on magnetic tape in any of the following formats. 


Format Mnemonic 

Internal (HOS default) I 

System internal ^ SI 

Stranger S 

Long block stranger L 

Foreign F 

Long block internal LI 


These data formats differ in their PRU (block) size and in their record and file mark 
indicators (refer to tcdsle 2-1) . Other format differences are as follows: 


Tape 

Format 

Labels 

I/O Mode 

Tape 

Paritv 

Noise Sizett 

1 ' 

Lcibeled or 

unlabeled 

Binary only ttt 

Odd 

Seven-track: 

ceight frames 





Odd 

Nine-track: 

<six freunes 

SI 

Lcibeled or 

unlabeled 

Binary onlytttt 

Odd 

Seven-track: 

<eight frames 





Odd 

Nine-track: 

<six frames 

s 

1 

Labeled or 

unlabeled 

Binary 

Coded 7-track 
Coded 9-track 
Coded cartridge 

Odd 

Even 

Odd 

Oddttttt 

User-selected 
default is 

} 

< 18 freunes 

L 

1 

Labeled or 

unlGd3eled 

Binary- 

Coded 7-track 
Coded 9-track 
Coded cartridge 

Odd 

Even 

Odd 

Odd ttttt 

User-selected 
default is 

/ 

< 18 frames 

F 

Unlabeled 
as data) 

(labels read Binary 

Coded 7-track 

Odd 

Even tttttt 

User-selected 
default is 

■} 

< 18 freunes 

1 LI 

Xiabeled or 

unlctbeled 

Binary only 

Odd 

Nine-track; 

<six frames 


t NOS/BE system default tape format (binary mode only). 

tt Tape blocks read that are smaller than the noise size are discarded. An attenpt to 
write a block smaller than the noise size produces an error message. Refer to the 
HS=sns parameter of the LABEL command. 

tttSpecification of coded mode aborts the job step; refer to TCOPY Command in section 9. 
I/O mode bit is ignored. 

Coded mode is supported only for labels. 

fffj-j-I/0 mode on write for F format is specified in the control word and is returned in the 
control word on read. 
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NOS terminates all blocks on I format tapes and all blocks that are not a full PRO on SI 
format tapes with a 48-bit block (PRO) terminator. The terminator contains the total number 
of 12-bit bytes in the block (including the terminator itself), the number of blocks since 
the last HDRl label, euid the level ninber of the block. This terminator enables read 
operations on I format tapes to check whether the number of bytes read and the block number 
expected match the byte count and block number in the terminator. If either does not match, 
the system attenpts to recover the missing data. This feature prevents dropped or 
fragmented blocks and provides a higher degree of reliadaility than other data formats. 

NOS prefixes all blocks on LI format tapes with a 60-bit block prefix. This serves the same 
function as the block terminator does for I format tapes. 

Tapes should be read with the same format specified as when they were written. Data is then 
recovered in its original form. For some formats, NOS writes extra bits which are discarded 
when the tape is read. I format auid LI format nine-track tapes are always written with an 
even multiple of 12-bit bytes per block. SI format nine-track tapes may have an extra 4 
bits written per block to preserve the lower 4 bits of a CM word. (A 60-bit CM word would 
be written in eight frames, 8 bits per frame.) 

All nine-track tapes are written with odd parity. Binary seven-track tapes have odd parity; 
coded seven-track tapes have even parity. If a parity error is detected on an F format 
seven-track tape, the recording mode (binary or coded) is automatically switched to allow 
reading of mixed mode tapes. 

All cartridge (CT and AT) tapes are written with odd parity. 

LI format Ceui be used only for CT, AT, and 6250-cpi NT tapes. 

In general, using the LI format improves treuisfer rates and total tape capacity over using 
the I format. This is because the block size used for LI format (lOOOOg words) is larger 
than the block size used for I format (lOOOg words) . This means that much less of the tape 
is wasted on inter-record gaps. However, since LI format requires the use of a CIO buffer 
at least lOOOOg words long, some user progreims and system utilities may not be able to read 
or write tapes in LI format. Increasing the size of the CIO buffer(s) in these programs 
corrects the problem. 

Volume 4, Program Interface, describes tape formats in greater detail. 


60459680 F 


2 - 10 . 1 / 2 - 10.2 




FILE TYPES 


The system maintains several tables for each job. Every file assigned to a job has an entry 
in one or more of these tables. A table entry for a file includes the file name, the device 
on which the file resides, file type, and its current position and status. 

The system assigns one or more of the following file types to files associated with a job: 

Input file type 
Queued file type 
Local file type 
Primary file type 
Direct access file type 
Library file type 


INPUT FILES 

An input file is also called a job file because it contains user-supplied commands and data 
for a job (refer to section 3). Initially, input files exist on mass storage in the input 
queue. A file enters the input queue directly when a local or remote batch job enters the 
system or indirectly when a user job submits another job via an LDI, ROUTE, or SUBMIT 
command. The input file for an interactive job is normally assigned to the terminal and is 
used by an interactive job to read data entered at the terminal into the program. A user 
job refers to its input file by the file name INPUT (refer to Input File Control in section 


QUEUED FILES 

A file is queued as a result of one of the following events: 

• Generally, whenever you enter a LDI, OUT, ROUTE, MFQUEUE, or SUBMIT command. Refer 
to the description of each individual command for cases where the command fails to 
queue a file. 

• Job termination. The system automatically queues files named OUTPUT, PUNCH, PUNCHB, 
and P8; deferred routed files; and other system—reserved output files if they are 
assigned to the job. In interactive jobs, however, the files OUTPUT, PUNCH, PUNCHB, 
and PB are not automatically queued. 

A queued file can have one of five dispositions: 

• Input 

• Plot 

• Print 

• Punch 

• Wait 
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Your job's origin type determines the default processing of your queued job output. Jobs 
originating at a central site card reader are queued to a line printer with the same 
system-defined identifier as the card reader. Similarly, the system queues remote batch 
output to the remote batch terminal where the job originated. The system gives each remote 
batch terminal a unique terminal identifier (TID) when it logs in and uses this TID for 
queueing files originating from the terminal. You can determine the default destination of 
batch output for your jobs by using the ENQUIRE command and specifying either the JSN=jsn or 
UJN=ujn parameter. ENQUIRE shows the default destination in the DS field of its display. 

RB indicates remote batch routing and BC Indicates routing to the batch devices at the 
central site. 

You can override the default queueing of job output with the LDI, QGET, ROUTE, SETJOB, or 
SUBMIT command (refer to section 7). 

Queued files with an input disposition wait until they are scheduled for execution. The 
service class of the job determines the scheduling priority of an input file. 

For queued files with plot, print, or punch dispositions, their priority grows as they wait 
in the queue. Such files are processed when the appropriate device becomes available and 
when the file’s priority is higher than all other files queued to that device. Refer to the 
ROUTE command in section 9 for an enumeration of disposition codes for plotting, printing, 
and punching. 

A file with a print disposition must be formatted for line printing. Most system utilities 
format file OUTPUT for printing, but you must include the appropriate printer control 
characters when you create a file to route to a printer (refer to the COPYSBF command and to 
appendix H). Files with uppercase and lowercase characters require special processing 
(refer to the FCOPY command). Appendix D contains the printer output from a sample job. 

A queued file with a wait disposition awaits further specifications from you. The system 
queues output from detached interactive jobs with a wait disposition unless you specify a 
different disposition. You can explicitly queue files with a wait disposition with the LDI, 
ROUTE, SETJOB, and SUBMIT commands. 

A file remains queued on mass storage until one of the following occurs; 

• The system resource it requires becomes available and the file's priority is the 
highest of all queued files with the same disposition. 

• You remove the file with the QGET or DROP command. 

• Site personnel remove it if it resides in the queue too long (site-determined). 

You can get a list of your queued files with the ENQUIRE command (refer to section 7). 


LOCAL RLES 

Files of local file type are temporary files. Although all files assigned to a job are 
considered local to the job, the local file type includes only those files assigned to your 
job that are not given one of the other file types. 

You can create a local file in many ways. The following list shows some implicit methods of 
creating a local file: 

• Name the file for the first time in a copy command or in a read or write command 

within a program. A local file created in this manner always resides on mass 
storage. 
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• Name the file for the first time in an ASSIGN or REQUEST command that assigns the 
local file to mass storage or to an interactive terminal or name the file in an 
ASSIGN, LABEL, or REQUEST command that assigns the local file to magnetic tape. 

• Name the file in a GET command generating a local mass storage file. 


• Name the file as the output file in a compiler-or assembler-call command. 

• Name the file as the list or output file in one of the file editing commands (MODIFY 
or EDIT, for example). 

To save the contents of a local mass storage file, you issue a SAVE or REPLACE command to 
copy the local file to a permanent indirect access file or an APPEND command to copy the 
local file onto the end of an existing permanent indirect access file. Data written on a 
local file assigned to magnetic tape is written on the tape for later access. Local files 
are released upon job completion. 


PRI/VURY HLK 

The primary file is a temporary mass storage file designated as the primary file by a 
PRIMARY, NEW, or OLD command. Only one primary file can exist for a job at a time. Some 
commands use the primary file as the default file when a file name is not specified. NOS 
rewinds the primary file before each job step. 


DIREa ACCESS HLES 

You assign a direct access permanent file to your job by issuing an ATTACH or DEFINE 
command. When you define the file or when you attach the file in a mode permitting file 
modification, you can write on the permanent file. Refer to Permanent Files in this section. 


UBRARY RLES 

^ library file is a read-only file that several users can access simultaneously. This file 
type should not be confused with system library programs or with public permanent files 
stored under user name LIBRARY. Refer to Libraries in this section for a description of the 
uses of the term library in NOS. 

You must be authorized to access a library file. 

If authorized, you can read a library file after naming it in a COMMON command. 


PERMANENT FILES 


Your permanent files reside on mass storage until you purge them or until your site archives 
them (contact your computer center for their archiving procedures). The system maintains a 
separate permanent file catalog for each user name and it contains entries for all of your 
permanent files created under the user name you are using to access the system. A catalog 
entry includes the file name, its location on mass storage, its length, permission modes, 
and access history. Unless another user name is specified, the system directs all permanent 
file requests to the files of the user specified on the last USER command (or specified in 
the login of an interactive job). 
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User names (refer to Validation in section 3) that contain asterisks represent users with 
automatic read-only permission to files in the catalogs of other users. The user name must 
match the other user name in all characters not containing asterisks. For example, the user 
with user name *AB*DE* can access the catalogs of the following users. 

• UABCDEF 

• UABDDEE 

• MABCDEl 

The device residence of permanent files and their backup copies are described under Mass 
Storage File Residence in this section. 

The two types of permanent files, indirect access permanent files and direct access 
permanent files, are described in the following paragraphs. 


INDIRECT ACCESS PERMANENT HLES 

You access an indirect access permanent file by naming it in an OLD or GET command. The 
system copies the permanent file from mass storage to a temporary file (primary or local 
file t3rpe). To alter an indirect access permanent file, you make the changes to the 
temporary copy and then enter the REPLACE command which writes the temporary copy over the 
Indirect access permanent file. You create an indirect access permanent file by naming a 
temporary file in a SAVE or REPLACE command. 

Mass storage for indirect access permanent files is allocated in 640-character blocks (64 CM 
words). Because of its small allocation block size, indirect files are most economical for 
relatively small files. 

The maximum size of an indirect access file is determined either by your validation limits 
(refer to the LIMITS command), or by the device limitations described in Mass Storage Files 
in this section. 


DIRECT ACC^ PERMANENT HLES 

You access a direct access permanent file directly, not through a temporary copy. Data is 
written directly on the permanent file. 

You create a direct access permanent file with a DEFINE command, which determines its name 
and residence and the default access mode available to other users. Other users may, if you 
permit, access the file with an ATTACH command. A number of users can attach the file 
concurrently, but only one user at a time can change the file. To change the file, you must 
attach it in modify, update, append, or write access mode. If you attach the file in write 
mode, no other user can attach that file concurrently. 

Even if a file is currently attached to a job, you can purge the file from the permanent 
file catalog with a PURGE command. However, the purged direct access file remains attached 
to the job until it is released by a RETURN, CLEAR, UNLOAD, OLD, or NEW command or until the 
job ends. 
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Hass storage for direct access pemanent files is allocated in large blocks; the block size 
depends on the mass storage device type on which the file resides (refer to Hass Storage 
Files in this section). Because of their large allocation block size emd the write 
interlock feature, direct access files are often used for database files. 

The maximum size of a direct access file is determined by your validation limits (refer to 
LIMITS Command in section 7), or by the device limitations described in Hass Storage Files 
in this section. 


MASS STORAGE FILE RESIDENCE 


For most mass storage file operations, you need not be concerned etbout the specific device 
on which your file resides. However, under certain circumstances, you may wish to override 
the default device residence for local or permanent files. 

With the ASSIGN comnand, you can assign a local file to either a specific device or to a 
device category if you are so authorized. 

Every permanent file you create resides either in your family of permanent file devices, on 
an auxiliary device, or on alternate storage. Unless you specify otherwise, all permanent 
files are saved in your family. Refer to the NOS 2 Analysis Handbook for further details. 


FAMILY DEVICES 


A family consists of a set of mass storage devices. Normally, a system has only one family 
(the default family) of peznicuient file devices. However, because families are 
interchangeable between NOS systems, several fcunilies may be active on one system, or a 
system may be part of a multimainframe system. For example, consider aui installation with 
two systems, A and B. System B provides backup service to system A. If system A failed, 
its family of permauient file devices could be introduced into system B without interrupting 
current operations on system B. 

You identify your family by supplying a one- to seven-character faunily name. You ceui 
specify a family name on the USER command. If you are authorized to use secondary USER 
ccznmaurids (refer to the USER commauid), you also specify a family naune on a USER command in 
interactive jobs. If your family is the system's default family, you may, but need not, 
supply the family name. When the family name is omitted, the system uses the system default 
family name. If your family has been introduced into amother system, you must supply your 
family name. 

If you choose to save files on family devices, you have the option of either using the 
system default device type or specifying another type of permanent file device. 
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AUXILIARY DEVICES 


An auxiliary device is a supplement to the mass storage provided by family devices. It is 
identified lay a one-to-seven-character pack name. An auxiliary device is not necessarily a 
disk pack that ceui be physically removed as the pack name itq;)lies. Rather, an auxiliary 
device can be any mass storage device supported by the system and defined as such by the 
installation. Each auxiliaury device is a self-contained pemicuient file device; all direct 
and indirect access files represented by the catalogs on the device reside on the device. 
Aiuciliary devices may be defined as public or private. Anyone who supplies the a^rppriate 
pack name can create, replace, and access files on a pviblic device. Only one user, the 
owner, can create and replace files on a private auxiliary device; but others may access or 
replace those files as permitted by the owner. 


ALTERNATE STORAGE 


Disk is the usual residence of permanent mass storage files. However, your site may choose 
to move sane files from disk to alternate storage (either to a catrtridge alternate storage 
I siabsystem such as MSB, to optical disk, or to tape alternate storage) . Alternate storage is 
well-suited for the storage of files that are accessed infrequently. Accessing a file 
residing on alternate storage takes extra time, because the file must be retrieved and 
copied (staged) to disk. You can specify the preferred residence of your permanent files 
with the PR parameter on the DEFINE, CHANGE, or SAVE conmands. You can ascertain the 
residence of your files with the CATLIST command. In the CATLIST output, file names 
surrounded by parentheses indicate that these files reside on alternate storage rather than 
on disk. 

Usually, when attaching a file from alternate storage, the system suspends the job until the 
file has been staged and assigned to the job. (You Ccui determine the status of your staging 
request for an alternate storage file with the ENQUIRE or cE command.) However, if you 
specify the RT parameter on the ATTACH, GET, or OLD command, the job will be allowed to 
continue processing while the file is being staged to disk. You must then issue a second 
ATTACH, GET, or OLD conmand to assign the file to your job after staging. If you specified 
the RT parameter you can then check whether the file has t>een attached by using either the 
FILE function (refer to section 6) or a LENGTH or ENQUIRE command. 

If a persuuient file is lost or destroyed, site personnel can recover the file lay loading its 
backup copy. Generally, sites perform regular dun^s of permanent files to magnetic tape to 
serve as the permanent file backup. By specifying the BR parameter on the DEFINE, CHANGE, 
or SAVE command, you can choose to have a tape bacloip cqpy of your file kept even if the 
file resides on alternate storage. You also can choose to have the alternate storage file 
copy serve as a backup, or you can require no backup copy of your file. 
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LIBRARIES 


As defined in the glossary (appendix C), the term library has several meanings. The 
applicable meaning for the term must be determined from its context. The following 
describes some NOS libraries. 


USER NAME LIBRARY 

Files stored under user name LIBRARY need not be libraries themselves. An installation 
saves programs or text as files under user name LIBRARY so that authorized users can access 
them from a centralized location. You can access those files by specifying the file name 
and the alternate user name LIBRARY on their permanent file request or by issuing a LIB 
command for indirect access files. 


PROGRAM UBRARIES 

A program library is a collection of compressed source deck images stored in Modify or 
Update format. You access these compressed source decks through MODIFY or UPDATE commands 
(refer to section 15). 


USER UBRARIES 

User libraries are the files named in the LIBRARY, SATISFY, LIBLOAD, or LDSET loader command 
or in program binaries. These files are searched by CYBER Loader to satisfy external 
references within a program it is loading. They contain compiled or assembled routines. 

The first record of a user library is a ULIB record; the last record is an OPLD record. 
Section 15 describes commands that create, catalog, and manipulate user libraries. 
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JOB FLOW AND EXECUTION 


3 


The primary job types are batch and interactive. A batch job is a file of commands and 
data. Its first record, called the command record, contains lines of text that specify NOS 
commands. Every batch job begins with a Job command and a USER command. The end of the 
command record is marked by an EOR (or an EOI if there is no data in the job). 

If records follow the command record, they contain program, data, or directive input for the 
commands. As each command requiring user input is processed, the system reads the next 
record in the input file (unless the command specifies otherwise). These records must be in 
the same order as the commands that use them. 

For example, figure 3-1 illustrates a job file. In this job file, the first two commands 
are processed by system routines that require no additional user input. The third command, 
FTN5(G0), requests the compilation and execution of a FORTRAN 5 program. The compiler reads 
the FORTRAN 5 source program from the second record of the input file. After successful 
compilation, the system executes the program. Because the program reads data from the input 
file, it takes input data from the third record of the input file. Normal job termination 
occurs when the system reads the command record EOR (the first 7/8/9 card). 

You can also consider an interactive job to be a file of commands and data. You do not 
submit the file to the system as a unit, but enter input one command at a time from a 
terminal. Generally, the system processes each command as soon as you enter it. However, 
you may group commands in a procedure and those commands are executed together when you call 
the procedure. 


JOB INITIATION AND TERMINATION 

The methods of job entry and termination differ for interactive and batch jobs. 


BATCH JOBS 

You can enter a batch job in the following ways: 

• Enter a job file through a local card reader. 

• Enter a job file through a remote batch terminal. 

• Enter a job file using the HELLO7, LDI, MFQUEUE, ROUTE, or SUBMIT command from an 

interactive or another batch job. 

To enter a job file through a remote batch terminal, you must use the Remote Batch Facility 
(RBF). Consult the Network Products Remote Batch Facility Version 1 Reference Manual for 
details. Section 7 describes the LDI and SUBMIT commands. Section 9 describes the MFQUEUE 
and ROUTE commands. 

Unless abnormally terminated, your batch job ends after the system executes the last command 
in the command record of your job file. 
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Figure 3-1. FORTRAN Compile and Execute Deck 


INTERACTIVE JOBS 

To enter an interactive job, you must use the Interactive Facility (lAF). Volumes 1 and 2 
of this reference set give a more detailed description of login and logout procedures for 
interactive jobs. Section 16 describes terminal and input/output conventions. 


Login 

Before you can login to a host computer, you must establish a connection with the network 
software. If you need Information on how to connect to Communications Control Program (CCP) 
software, refer to Volume 2, Guide to System Usage. If your network uses CDCNET, refer to 
the CDCNET Access Guide. 

Once you have established a network connection, you can begin the login sequence. 
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The following example shows an abbreviated login sequence.t Your entries appear in 
lowercase characters. 


WELCOME TO THE NOS SOFTWARE SYSTEM. 

COPYRIGHT CONTROL DATA 1978,198X. 

YY/MM/DD. HH,MH,SS T02A57 

NETWORK OPERATING SYSTEM NOS 2 

FAMILY: ,usernatn,passwrd,iaf 

YOUR PASSWORD WILL BE EXPIRED YY/MM/DD 

JSN: AEYT, NAMIAF 

READY. 


The second line of the login sequence gives the original copyright date of NOS software and 
the copyright date of your version of NOS. The third line gives the current date and time, 
and the name of your terminal. 

After the system validates your user name and password, it assigns your job a job sequence 
name (JSN). The JSN in this example is AEYT. 

If you have recoverable jobs in the system, the system initiates a recovery dialogue with 
you immediately after it logs you in. 


I NOTE 


Using a network to recover a job other than 
the one you were using before the job was 
disconnected may not always work. For this 
reason, we recommend that you always use 
the same network to recover a job. 


t This manual assumes that your system does not require the entry of a personal identifier. 
For more information about the personal identifier refer to Volume 2 of the NOS 2 
Reference Set. 
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The following example shows a login sequence where you have recoverable jobs.t Again, your 
entries appear in lowercase characters. 


WELCOME TO THE NOS SOFTWARE SYSTEM. 

COPYRIGHT CONTROL DATA 1978, 198X. 

YY/MM/DD. HH.MM.SS T01A75 

NETWORK OPERATING SYSTEM NOS 2 

FAMILY: ,usernam,passwrd,iaf 

YOUR PASSWORD WILL BE EXPIRED YY/MM/OD 

JSN: ADYE, NAMIAF 

RECOVERABLE JOB(S) 


JSN 

UJN 

STATUS 

TIMEOUT 

AARQ 

AN2A 

SUSPENDED 

26 

MIN. 

AASF 

AN2A 

SUSPENDED 

28 

MIN. 


ENTER 60 TO CONTINUE CURRENT JOB, 

RELIST TO LIST RECOVERABLE JOBS, 
OR DESIRED JSN: go 

READY. 


Additionally, some sites may require you to enter charge information during login (refer to 
CHARGE command in section 7). 


Logout and Application Switching Procedure 

When you have finished using lAF, you can either log out or switch to another application. 
The logout procedure disconnects you from the host. Application switching ends your session 
with lAF but allows you to continue processing under the control of another application 
(such as RBF). 

To terminate your terminal session, enter one of the following: 

GOODBYE or BYE or LOGOUT 


The system responds by printing: 


UN=username LOG OFF 
JSN=jsn SRU-S 

CHARACTERS=xxxxxKCHS 
lAF CONNECT TIME 
LOGGED OUT. 


hh.mm.ss. 
s.sss 

hh.mm.s s. 


This display is followed by additional logout information provided by network software. 


t This manual assumes that your system does not require the entry of a personal identifier. 
For more information about the personal identifier refer to Volume 2 of the NOS 2 
Reference Set. 
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The following is a description of the variable items in the logout display: 


Item 

username 

hhaiom.sSi 


jsn 
s .sss 

xxxxxxxx 

ct 

had 


Description 


User name you entered during login. 

The first occurrence of hh.mm.ss. indicates the time of 
logout. The second occurrence indicates the length of time 
your terminal was connected to lAF. 

Your job sequence name. 

A measure of the system resources used while connected to lAF. 

A count of the total number of input and output characters read 
from, or written to, your terminal. 

The network control character for your terminal. (The network 
control character for specific terminal models are listed in 
Table J-1.) 

The host availability display (HAD). The HAD appears if you 
have enabled it with the HD terminal definition command (refer 
to appendix J) or if you are operating in a multihost 
environment. 


lAF automatically logs out the terminal if no activity has been registered in a site-defined 
timeout period (the default is 10 minutes; if your terminal is in SCREEN mode, the timeout 
period is doubled), unless you have a no-timeout terminal status. Refer to the discussions 
of the LIMITS and SCREEN commands for further information. 

When lAF logs out a dial-up terminal to the system, the system automatically disconnects the 
terminal after a site-determined period of time (2 minutes is the default). You may wish to 
log out without disconnecting the terminal. To log out of the system and reinitialize the 
login sequence, enter: 

HELLO 

or 

LOGIN 

lAF logs out the current job, issues the normal logout messages, and then causes the network 
to initiate a new login sequence. Any terminal characteristics, such as page width or 
terminal class set in the previous job, remain in effect. 
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If you wish to leave the lAF application but remain connected to the network and use another 
application, you can enter one of the following: 

BYE,application 

GOODBYE,application 

HELLO,app1ication 

LOGIN,application 

LOGOUT,application 

In these commands, the term application means a product that uses the network for terminal 
communications. Other applications include TAF, MCS, TVF, PNI, and RBF (refer to the BYE 
command in section 8). Other site-provided applications may also be available. All 
terminal characteristics in effect under lAF remain in effect under the new application. 

After you enter one of the above commands, the system prints the logout message and 
disconnects the terminal from lAF. If the site has authorized you to access the 
application, the system connects the terminal to the named application. If the named 
application is not present or if the site has not granted you access to this application, 
the system issues an error message and the prompt: 

terminalname - APPLICATION; 

where terminalname is the name the network has given your terminal. 

You can again enter the name of an application, or you can enter BYE or LOGOUT to log out or 
HELLO or LOGIN to reinitiate the login sequence. 


SUBMITTING JOBS TO REMOTE HOSTS 

Some sites use multiple host network configurations in which you can log in to a host 
mainframe and then submit jobs to other mainframes (remote hosts) in that computer system. 
There are various ways in which sites can configure these computer systems, and the means by 
which you submit jobs to a remote host depend on your system configuration, the type of 
remote host, and the nature of the jobs. In all cases, however, you must have special 
authorization to submit such jobs (refer to the LIMITS command in section 7). 

In general, you can submit a batch job to a remote host by specifying the remote host with 
the ST=lid parameter of the Job command or the ROUTE command. If the remote host is a 
SCOPE 2 system and the batch job requires interactive input or output, use the HELL07 
command. If the remote host is connected through the Queued File Transfer Facility (QTF) 
and the batch job has special routing requirements (requirements not provided by ROUTE 
parameters), use the MFQUEUE command. If you want to retrieve or change the attributes of 
permanent files on such a remote host, you need not submit a complete batch job. You can 
use the MFLINK command from a job on your host mainframe. 

If you want to connect your interactive terminal to a Virtual Storage Operating System 
(operable on a CYBER 200 computer system), select the Interactive Transfer Facility (ITF) 
during login or with the BYE, GOODBYE, HELLO, LOGIN, or LOGOUT command. 

In a dual-state system, you can submit a batch job from the NOS system to the NOS/VE system 
using the ROUTE command. The ROUTE ST=lid parameter routes a NOS file to the NOS/VE batch 
input queue. The file must be written in 6/12-bit display code. 
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Figure 3-2 summarizes the methods of submitting jobs to remote hosts 


Command/Application 

Type of Job Being Submitted 

Special Host Type/ 
Connection Type 

Job Command 
(ST“lid parameter) 

ROUTE Command 
(ST=lid parameter) 

Batch 

No special 
requirements. 

HELL07 Command 

Batch (with interactive I/O) 

SCOPE 2 system. 

MFQUEUE Command 

Batch (with special routing requirements) 

RHF (LCN, CDCNET, 
or CCP). 

ITF Application 

Interactive 

VSOS system 
(CYBER 200). 

MFLINK Command 

Part of a batch or interactive job 
(permanent file manipulations) 

RHF (LCN, CDCNET, 
or CCP). 


Figure 3-2. Submitting Jobs to Remote Hosts 
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JOB ORIGIN TYPES 


When a job enters the system, the system determines the job origin type according to the 
means used for job initiation. Its origin identification remains with the job throughout 
job processing. The job origin type determines how the job is handled and how it exits from 
the system. 

The four origin types and their system symbols are as follows (system symbols are described 
in section 6): 


Origin Type Symbol 

System SYO 

Interactive lAO 

Local batch SCO 

Remote batch RBO 


System origin jobs originate at the system console, interactive jobs all enter through lAF, 
local batch jobs enter through central site batch devices, and remote batch jobs enter 
through RBF. 

If you are so authorized (refer to the LIMITS command), you can also initiate jobs using the 
HELL07, MFQUEUE, LDI, ROUTE, or SUBMIT commands. Depending on how you specify the 
parameters of these commands, the resulting jobs can either be local batch or remote batch 
in origin type. 


JOB SERVICE CLASSES 

Every job in the system is assigned a service class. This service class determines the 
job's scheduling priority as the job flows through the system. You can make this service 
class assignment or you can let the system assign it a default service class based on the 
job's origin type and your validation limits (the privileges your site has granted you). 

Unless changed by your site, the system has the following 14 service classes: 


Service Class 

Two-character 

Mnemonic 

One-character 

Mnemonic 

Deadstart 

DS 

A 

System 

SY 

S 

Local batch 

BC 

B 

Remote batch 

RB 

R 

Interactive 

TS 

T 

Detached interactive 

DI 

D 

Network supervisor 

NS 

N 

Subsystem 

SS 

X 

Maintenance 

MA 

M 
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Service Class 


One-character 

Mnemonic 


Two-character 

Mnemonic 


Communication task 


CT 

Installation class 

0 

10 

Installation class 

1 

11 

Installation class 

2 

12 

Installation class 

3 

13 


C 

0 

1 

2 

3 


The scheduling priority associated with each service class is site-determined. You can 
ascertain how your site has prioritized the service classes you are authorized to use for 
each origin type by using the CLA.SS command. To determine the service class of a job, use 
the ENQUIRE command. The system denotes the service class with a one-character mnemonic in 
the SC field of the ENQUIRE output. 


Your site allows you to use only a subset of the service classes. The LIMITS command shows 
you which service classes you can use. Further, your site can restrict the use of certain 
service classes to jobs of certain origin types. The CLASS command displays this 
information. 

You can assign a service class to a job in the following ways: 

• Use the CHVAL command to specify default assignments for your jobs according to 
origin type. The system uses one of these default assignments if you do not 
otherwise make a service class assignment in a job. The LIMITS command shows what 
your default service class assignments are for each origin type. 

• Use the SC=class or P=priority parameter of the Job command for batch jobs. 

• Use the CLASS command to change the service class of your current job. 

• Use the SCL=scl parameter of the ROUTE command for jobs to be initiated by that 
command. 


JOB NAMES 

Every job in the system receives a job sequence name (JSN) and a user job name (UJN). This 
Includes not only your job file, but files you explicitly route for disposal during your 
job, such as files routed to a line printer. These job names are the primary job 
identifiers for both the system and you. Many system commands use the JSN and UJN as 
parameters. You can get a list of the JSN and UJN of all your active jobs by using the 
ENQUIRE command. 


JOB SEQUENCE NAME (JSN) 

The system assigns every job a unique JSN. Each JSN consists of four alphabetic 
characters. The banner page of batch output prominently displays the job's JSN; the JSN 
appears as the last four characters of the eight characters in block letters (refer to 
appendix D for a sample banner page). 
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USER JOB NAME (UJN) 


The UJN is for your convenience. You can select a meaningful name (a maximum of seven 
characters) by which to identify your jobs. For batch jobs, you can set the UJN with the 
SETJOB or ROUTE command. If not otherwise specified, the UJN for batch jobs defaults to the 
UJN specified on the Job command. For interactive jobs, you can specify the UJN with the 
SETJOB command. The UJN for interactive jobs defaults to the user index hash (refer to the 
ENQUIRE command). 


VALIDATION 

In batch jobs, the USER command follows the Job command and is used to identify you as an 
authorized user. If you are an authorized user, a set of control values associated with 
your user name is used by the system to control all system requests from your job. If you 
are not permitted to perform specific functions (such as access nonallocatable devices) and 
you attempt to use them, your job will be terminated. 

To get a listing of resources at your disposal and of special permissions you possess, enter 
the LIMITS command. To change your resource allocation or to get additional permissions, 
contact installation personnel. 


ACCOUNTING 

The unit of accounting for the system is the system resource unit (SRU). The SRU is a 
composite value of central processor time, I/O activity, and memory usage. SRU operations 
are initiated at the beginning of a job and reinitiated whenever another CHARGE command is 
encountered. SRU information includes: 

• Central processor time 

• Mass storage activity 

• Adder activity (fixed charges for some system requests whose resource requirements 
are highly variable and beyond your control) 

• Magnetic tape activity 

• Permanent file activity 

• Central memory and extended memory usage 

• SRU value 

• Matrix Array Processor (MAP) activity 

• Application account chargest 

This information is written to the job's dayfile at the end of the job or whenever this 
job's service class changes. You may request SRU information to be written to your output 
file at any time during the job by issuing the ENQUIRE command. The format of SRU 
information written in the dayfile is given under Job Completion in this section. 


tNot currently supported by the system but reserved for future use. 
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JOB SCHEDULING 

When a job enters the system, it is queued for input and waits for the required system 
resources to become available or its priority to grow. The job's priority depends on its 
service class. The system priorities are system-defined and can be altered only by the 
system operator. The scheduling priority of the job is advanced as the job waits. The 

ages to a system—defined limit. The job scheduler periodically scans the queued 
jobs and active jobs to determine whether action is necessary to ensure that the highest 

jobs are being serviced. This action may Include rolling out low priority jobs or 
rolling in higher priority jobs. The job scheduler is also activated to analyze the system 
status whenever there are changes (for example, when the field length of a job is released, 
a job is queued, or a job completes). 

Once a job is scheduled for execution, normal command processing begins. The general flow 
of the command processing is Illustrated in figure 5-1. 


JOB CONTROL 

While the job is executing, the system exercises the following controls over the job. 


BBD LENGTH CONTROL 

The system controls the field length (central memory) assigned to a job, adjusting it 
according to the requirements of each job step. CYBER Loader further adjusts the field 
length during both program loading and program execution. Memory may be added or removed as 
the needs of the program change. Refer to the description of the REDUCE command in the 
CYBER Loader Reference Manual. You can further influence the field length assigned to your 
job by using the CM parameter of the Job command and the MFL and RFL commands. 

The maximum field length for a job (MAXFL) is set at the smallest of the following values. 

• The value of the CM parameter of the Job command if specified 

• Maximum field length you are authorized to use 

• Maximum field length available for user jobs (dependent on machine size) 

For any job step, the maximum field length is the smaller of MAXFL or the value you 
specified with the MFL command. 

The running field length (RFL) is initially set to zero, indicating system control of field 
length. The RFL command changes RFL. RFL cannot exceed the current MFL. 

To set the initial field length for a job step, the system uses the first value set by one 
of the following. 

• Predefined initial field length for a system routine or on a global library set 
(RFL = special entry point). 

• Highest high address (HHA) from EACP loader table (54 table) (refer to the CYBER 
Loader Reference Manual). 
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• RFL value, if nonzero. 

• The smaller of the MFL or the installation-defined default value (release value 
50000B). 


rNOTE I 

The system automatically assigns a field 
length for CM only. To set the initial 
field length for a job step in extended 
memory, use the RFL command or the MEMORY 
macro (refer to Volume 4, Program 
Interface). 


The following example shows a command record, the MAXFL, MFL, and RFL settings, and the 
actual field length (expressed in octal) used to process each command. 


Command 

MAXFL 

MFL 

RFL 

Field 

Length 

Explanation 

JOB,CM60000. 

USER,USERABC,1234. 

60000 

60000 

60000 

60000 

0 

0 

3200 

3200 

The CM parameter sets 
the MAXFL and MFL 
values. The system 
sets the field length 
as required for pro¬ 
cessing the command. 

GET,ABSPROG,RELPROG. 

60000 

60000 

0 

2500 

GET command retrieves 
copies of an absolute 
program and a relocat¬ 
able program. 

RFL,40000. 

60000 

60000 

0 

2300 

The user issues an 

RFL command to set 
the field length for 
execution of the abso¬ 
lute program that 
follows. 

ABSPROG. 

60000 

60000 

40000 

40000 

The absolute program 
on file ABSPROG is 
executed within a 
40000-word field 
length. 

MFL,50000. 

60000 

60000 

40000 

2300 

The user issues an 

MFL command to set 
the maximum field 
length for the follow¬ 
ing relocatable load. 

RELPROG. 

60000 

50000 

0 

50000 

If more than a 50000- 
word field length is 
required, the job 
aborts. 
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INPUT niE CONTROL 


Batch jobs, when initiated, have a file named INPUT (input file type). This file contains 
the commands and other input records required for job execution. INPUT is a locked file. 

As a result, you may read from it and reposition it, but the system does not allow you to 
write on it. If for some special reason you need to write on a file named INPUT, you should 
first issue a RETURN(INPUT) command. This command changes the name of the file from INPUT 
to INPUT* and leaves it assigned to your job. You may then write on file INPUT. The change 
of name caused by the RETURN command applies only if the file has an input file type (refer 
to File Types in section 2). 

For interactive jobs, file INPUT* is present at the beginning of the session and cannot be 
returned with a RETURN command. You can create and manipulate a file called INPUT at any 
time, although various products, such as the Full Screen Editor, require special processing 
in order to handle files named INPUT or OUTPUT as data files. 


TIME UMIT CONTROL 

The system sets a default time limit for each job step unless the Job command or the SETTL 
command specifies a job step time limit. This time limit is the amount of central processor 
time that any one job step is allowed. You cannot increase the limit beyond that for which 
you are authorized. 

While a job is using the central processor, the CPU time is accumulated and checked against 
the time limit for each job step. If the job's origin type is not interactive, the job in 
execution terminates or enters exit processing when the time limit is reached. Interactive 
jobs are suspended, after which you can increment the time limit and resume execution from 
the point of suspension (refer to SETTL Command for an example). In the case of a detached 
Interactive job, the system suspends or terminates the job according to the parameter values 
of the SETJOB command. You cannot resume jobs suspended in this fashion from the point of 
suspension; they enter exit processing. 


SRU UMIT CONTROL 

The system sets a limit on the number of system resource units (SRU) that a job step or an 
account block can accumulate. An SRU includes central processor time, central memory usage, 
permanent file activity, and mass storage and tape I/O. An account block is that portion of 
a job from one CHARGE command to the end of the job or to another CHARGE command. You may 
®lter these limits through the SETJSL and SETASL commands or macros; however, you may not 
set either limit beyond that for which you are validated. 

While a job is in the system, SRUs are accumulated and checked against the SRU step and 
account block limits. If either limit is reached, the system treats the job as if it 
exceeded its time limit for a job step, which is described in the preceding subsection. 


COMMAND UMIT CONTROL 

The system sets a limit on the number of commands you can enter in a job. You can ascertain 
this limit by entering the LIMITS command. If your job exceeds this limit, the system so 
informs you and allows you seven additional commands before terminating your job. The 
ENQUIRE,U command gives the number of commands you have entered in your job. 
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ROLLOUT CONTROL 


Each executing program is allowed to reside in CM for a certain amount of time before 
relinquishing its space to another program. When this CM time slice is exceeded, the 
program may be rolled out. This means that the contents of the job field length (both CM 
and extended memory), the job control area, and the control registers (exchange package) are 
written to mass storage. The program remains on mass storage until it is rolled back into 
memory. Execution resumes from the point where rollout occurred. The amount of time the 
job is allowed to occupy CM is called the central memory time slice. The central memory 
time slice is a system parameter that can be changed only by the system operator; time 
slices vary for each origin type. Whether a job is rolled out when its time slice expires 
depends on several factors. 

• Whether there are jobs waiting for execution. 

• Whether the jobs that are waiting have a higher priority. 

• Whether jobs that are waiting require more field length than would be available if 
all jobs of lower priority were rolled out. 

When a job is rolled out, it is assigned a priority. The priority assigned is a system 
parameter that depends on a job's service class and can be changed only by the system 
operator. The job's priority increases while the job waits. Normally, all other factors 
being equal, the job with the highest priority is selected to be rolled in. 


ERROR CONTROL 

When job step activity ceases, the system must determine the next command to process. If 
activity ceased due to normal termination, the next command processed is the next command in 
sequence. If an error caused activity to cease, the system issues the appropriate dayfile 
message and exits from the job. 

Errors may be detected by system software or hardware. When the system hardware detects an 
error condition, NOS Issues two or more dayfile messages. The first message gives the 
address where the error was detected; the second and following messages give the types of 
errors that occurred. NOS then dumps the exchange package for the job either to OUTPUT, for 
local batch and remote batch origin jobs, or to local mass storage file ZZZDUMP, for 
interactive jobs (refer to section 14). ZZZDUMP is not rewound before or after the dump. 

After issuing the appropriate dayfile message(s) for the error(s), the system searches for 
an EXIT command. If an EXIT command is found, processing continues with the command 
following EXIT. If an EXIT command is not encountered, the system terminates the job. 

(Exit processing is further described in section 5.) If a NOEXIT command is in effect, the 
system does not search for an EXIT command on subsequent errors, and processing continues 
with the next command. 

You can specify the error exit mode on which the system is to abort a job step with the MODE 
command. For example, you can specify that address out of range,t operand out of range, 
and/or indefinite operand errors are allowed and program execution continues (refer to 
section 6). The default error exit mode specifies that all errors terminate the job. 

The EREXIT, RECOVR, REPRIEVE, and MODE macros control error processing in COMPASS programs.. 
The SETLOF macro specifies file completion procedures when a job step abort occurs. These 
macros are described in Volume 4, Program Interface. 


tNot applicable to model 176. 
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SECURITY FEATURES 


A NOS computer system provides extensive protection of information contained in your jobs 
and files. Most notably, it protects the central memory associated with your active jobs 
and it enforces job and file access controls. 


MEMORY PROTECTION 


A job cannot dump or directly change the contents of the job field length immediately after 
a protected command or a user program. The following is a list of protected commands and a 
list of load/dump memory commands: 


Protected Commands 


APL 

COPYCF 

GET 

PACKNAM 

SCOPY 

APPEND 

COPYCR 

IF or (IFE) 

PASSWOR 

SECHDR 

ASSIGN 

COPYEI 

LABEL 

PERMIT 

SET 

ATTACH 

COPYSBF 

LDSET 

PROFILE 

SETFS 

BEGIN 

COPYX 

LIBEDIT 

PURGE 

SKIP 

BLANK 

DAYFILE 

LIBLOAD 

RECOVER 

SORT 

CATALOG 

DEFINE 

LIBTASK 

REDUCE 

SUBMIT 

CATLIST 

DISPLAY 

LIMITS 

REPLACE 

TCOPY 

CHANGE 

EDIT 

LOAD 

REQUEST 

UNLOAD 

CHARGE 

ELSE 

MAP 

RESOURC 

UPROC 

CHVAL 

ENDIF 

MFLINK 

RESTART 

USER 

CLASS 

ENDW 

MFQUEUE 

RETURN 

VERIFY 

CLEAR 

ENQUIRE 

NEW 

REVERT 

VFYLIB 

COPY 

EXECUTEt 

OLD 

REWIND 

VSN 

COPYBF 

FSE 

OUT 

SATISFY 

WHILE 

COPYBR 

FTP 

OVWRITE 

SAVE SCOPY 



Load/Dump Memory Commands 


CKP DMD DMP LBC PBC WBR 

DMB DMDECS DMPECS LOC RBR 

In an interactive job, you cannot enter a load/dump memory command individually or as the 
first command of a procedure. If you attempt to change or dump protected memory, the system 
issues an informative message to the dayfile and terminates the job step. 


This form of memory protection does not apply if the job is of system origin or if you have 
system origin privileges and debug mode has been set at the system console. 


SYSTEM AND FILE ACCESS CONTROLS 

NOS operates in either secured or unsecured mode, depending on the option selected by your 
site. On an unsecured system, the primary control of system access is based on user names 
and user passwords. NOS may also require certain users to enter a personal identifier in 
addition to their user name and password to gain system access. Additionally certain users 
may also be restricted to a single terminal session at a time. 

t This applies to EXECUTE when used as a loader command. It does not apply to EXECUTE when 
used to select the execute subsystem in an interactive job. 
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The system further restricts the use of certain system resources (for example, applications 
and special commands) to those explicitly granted that privilege by your site. NOS enforces 
file access controls based on user names, file passwords, and permissions granted by the 
owner of the file. The controls based on file passwords and permissions are discretionary; 
they are set at the discretion of the file owner. 

In a secured system, NOS enforces an additional set of access controls based on security 
access levels and categories. These controls limit access to information based on the 
user's validated clearance level and need-to-know categories versus the security access 
level and category markings associated with each file. These mandatory controls take 
precedence over the discretionary controls, which also remain available. 

You must be validated to use one or more security access levels and zero or more security 
access categories. Every file on a secured system has a single security access level and 
may have one or more access categories associated with it. To access a file, the user job 
must be validated for the file's security access level and for all of the file's access 
categories. 


SECURITY ACCESS LEVELS 

A security access level limits the disclosure of sensitive information to persons who are 
authorized to access information at the level of sensitivity indicated by that access 
level, A secured system supports up to eight security access levels. The number of access 
levels to be used, the names of those levels, and the degree of sensitivity associated with 
each level are selected by your site. The access levels are ordered so that the most 
sensitive information is associated with higher access levels. (The access levels have 
numerical values of 0 through 7; the corresponding released default names are LVLO through 
LVL7.) You are validated for a set of security access levels (normally a contiguous range 
of levels, such as LVLO through LVL4). 

The system associates a set of access levels with each job. This set is the intersection of 

your validated set of access levels, the range of levels currently valid for the system, the 

range of access levels allowed for your job's origin type, and, if specified by the system, 
the range of access levels allowed over your communication line to the computer. For 
interactive jobs, your job's initial access level is the lowest level in the set of access 

levels for your job. For batch jobs, the initial access level is the access level of the 

local file that Initiated the job. 

Example 1; You are validated to use levels LVLO through LVL5, the system is currently 
validated for levels LVLO through LVL7, your job origin type has an access level range 
of LVLl through LVL4, and your communication line has an access level range of LVLO 
through LVL3. As shown in table 3-1, your job will have an access level set of LVLl 
through LVL3 and the job's initial access level will be LVLl. If this job is initiated 
via a ROUTE or SUBMIT of a local file with access level LVL2, that will be the job's 
initial access level. 
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Table 3-1. User Job Access Levels 


LVLO 


LVLl 


LVL2 


LVL3 


LVL4 


LVL5 


LVL6 


LVL7 


User 

System 

Job Origin 

Communication 

Line 


X 

X 


X 

X 

X 

X 


X 

X 

X 

X 


X 

X 

X 

X 


X 

X 

X 


X 

X 


User Job 


Each file has a security access level. Unless you specify otherwise, each file you create 
will have the same access level as your job at the time you create the file. You can always 
raise the access level of your files (refer to the SETFAL and SETPFAL commands) to any level 
for which your job is validated, but you must have special permission to lower the access 
level of your files. However, the access level of direct access files or tape files cannot 
be changed while they are assigned to your job. If the access level of such a file is lower 
than that of your job, you can always read information from the file but can only write 
information to it if you have special authorization. The access level of a local file is 
automatically raised to the current job access level whenever an operation is performed on 
the file (this includes your primary file). 

Your job's access level is automatically raised whenever you read information from a file 
that has a higher access level than your job's current access level (within your job's 
validated set of access levels). You can always raise your job's access level using the 
SETJAL command to any level for which your job is validated, but you must have special 
permission to lower the access level of your job. 

Example 2: In the job referred to in example 1, you attach a file that has access level 
LVL3 and read information from that file. The access level of your job is immediately 
raised from LVLl to LVL3. 

Example 3: In the same job, you attempt to set your job's access level to LVL5 using 
the SETJAL command. This attempt fails because LVL5 is not in your job's validated set 
of access levels. 

Unless you are specifically validated, a secured system does not allow you to write 
information from a file with a higher access level into a file with a lower access level. 

Example 4: You attempt to copy a portion of a file whose access level is LVL2 to a file 
whose access level is LVL3. A secured system allows this operation. 

Example 5: You attempt to copy a portion of a file whose access level is LVL3 to a file 
whose access level is LVL2. A secured system does not allow this operation (unless you 
possess special validation). 
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On an unsecured system, you may set access levels on your files (for informational purposes), 
but the system does not use those levels to restrict access to the files, nor does it 
propagate those levels to your job or to other files. No job has an access level on an 
unsecured system. 


SECURITY ACCESS CATEGORIES 

A secured system supports up to 32 security access categories. The number of categories to 
be used and the names of those categories are selected by your site. The access categories 
have numerical values of 0 through 31; the corresponding released default names are CATOO 
through CAT31. Each user is validated for subset of the site-defined access categories. 
Your job's access category set is the intersection of this subset and the set of categories 
currently valid for the system. 

When you create a permanent file (using the SAVE or DEFINE command), the file is automati¬ 
cally assigned all of the access categories in your job's access category set. You have the 
choice to explicitly assign all, any, or none of these categories to each of your permanent 
files (refer to the SETPFAC command). Access categories restrict the access of your 
permanent files to those users who are validated for all of the categories you have set for 
the files. 

Example 6: You are validated for the categories CATOl, CAT06, CAT18, and CAT22. Using 
the SETPFAC command, you assign the categories CAT06 and CAT22 to permanent file ABC, 
which has an access level of LVL3. You then make file ABC public. Any user in your 
family who is validated for access level LVL3 and the categories CAT06 and CAT22 can 
then access file ABC. 

On an unsecured system, you may assign access categories to your permanent files for 
Informational purposes, but the system does not use those categories to restrict access to 
the files. 


RESPONSIBILITIES FOR DATA SECURITY 

In a secured system, security access levels and categories are checked whenever a user 
accesses a file, begins a job, or attempts to alter the security parameters of a file or 
job. This ensures that only those persons who are validated for the access levels and 
categories you have assigned to your files can access them. A secured system thus provides 
continuous protection of your data. 

Although the system will automatically assign an access level and an access category set to 
each file you create, you are responsible for ensuring that the access level and access 
category set assigned to each of your files is appropriate. Your site should provide 
guidelines for the use of the different access levels and categories it has established. 

All of the NOS security mechanisms depend on the protection of your user password. NOS 
provides the following mechanisms to help protect your password during interactive login: 

• You should always use the secure login procedure (described in section 8) to ensure 
that you are communicating with the system-supplied login mechanism. 
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• If possible, you should set your terminal to full duplex and enable echoplex mode 
(refer to the EP terminal definition command). The network temporarily disables 
echoplex when you enter your password during login. If you use the abbreviated 
login sequence, all fields in the line containing your password will be masked. 

This NOS security feature prevents display of your user password at your terminal. 

• A warning message stating when your user password is going to expire is displayed at 
your terminal and is issued to the job dayfile. 

Although NOS encrypts your user password after login, the programs you execute can affect 
the security of your files and validation information. When you execute a program, it can 
access the command record of your job. It is possible that a program belonging to another 
user can obtain privileged information like your user name and charge numbers. 


SECURITY CONFLICT PROCESSING 

When your job attempts to perform an operation that could violate system security, the 
system identifies the operation as a security conflict and issues a SECURITY CONFLICT 
message. A security conflict causes the job step to be aborted and decrements your security 
count (you are given a specific security count by the site security administrator). If your 
security count is decremented to zero, your current job or interactive session is terminated 
without EXIT processing. You are not allowed any additional jobs or logins until the 
security administrator resets your security count. 

On an unsecured system, a security conflict occurs in the following cases: 

• An incorrect secondary USER command. 

• A job file submitted with a SUBMIT or ROUTE command has an incorrect USER command. 

On a secured system, a security conflict arises in the following cases in addition to those 
listed above: 

• An attempt to set an invalid access level on a file or job. 

• An attempt to access one of your permanent files from a job that is not validated 
for the access level or access category set of the file. 

• An attempt to write data on a tape file or an attached direct access file when the 
access level of your job is higher than the access level of the file. 

• An attempt to set an access level for a file or job which is lower than the current 
access level of the file or job.T 


JOB COMPLETION 


When there is no more activity at a control point, no outstanding central processor 
requests, and no commands to process, the job is completed in the following manner. 

1. All CM assigned to the job is released. 

2. Extended memory assigned to the job is released. 

TThis action does not constitute a security conflict if you have special authorization to 
do so (refer to the LIMITS command). 
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3. All equipment assigned to the job is released. 

4. All library files attached to the job are released. 

5. All scratch (local) file space used by the job is released. 

6. All direct access permanent files attached to the job are released; the status 
information for these files is updated. 

7. The following summations of job activity are added to the end of the job dayfile. 
This information is also issued to the associated account dayfile for site usage. 

• Adder activity in kilounits (incremented by USER commands, CHARGE commands, 
and resource assignments). 

hh.mm.ss.UEAD, xxxxxx.xxxKUNS. 

• Permanent file activity in kilounits: 

hh.mm.ss.UEPF, xxxxxx.xxxKUNS. 

• Mass storage activity in kilounits: 

hh.mm.ss.UEMS, xxxxxx.xxxKUNS. 

• Magnetic tape activity in kilounits: 

hh.mm.ss.UEMT, xxxxxx.xxxKUNS. 

• Accumulated central processor time in seconds:t 

hh.mm.ss.UECP, xxxxxx.xxxSECS. 

• SRU value in units for total job usage including CPU time, I/O activity, and 
memory usage: 

hh.mm.ss.AESR, xxxxxx.xxxUNTS. 

• Matrix Array Processor (MAP) III accumulator: 

hh.mm.ss.AEMP, xxxxxx.xxxUNTS. 

0 Application activity: 

hh.mm.ss.UEAC, xxxxxx.xxxUNTS. 


tIf the Installation defines a CPU multiplier value, the value given is the product of the 
actual CPU seconds and the multiplier. The installation may assign a different CPU 
multiplier value to each CPU within a dual-processor machine (refer to the NOS 2 
Administration Handbook). 
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8. The following information is printed at the end of files queued for printing. 

• Lines printed in kilolines: 

hh.tmn.ss.UCLF, mi,es, xxxxxx.xxxKLNS. 
or 

hh.mm.ss.UCLV, mi,es, xxxxxx.xxxKLNS. 
mi Machine identifier. 

es Equipment status table (EST) ordinal of the output device. 

The UCLV summation is issued if the V carriage control character was used 
(refer to appendix H). 

9. The following information is issued to the account dayfile only. 

• Cards punched in kilocards: 

hh.mm.ss.jsn. UCPC, mi,es, xxxxxx.xxrfCCDS. 

10. For batch jobs, the job dayfile is copied to the end of file OUTPUT. If OUTPUT does 
not exist or if it is a deferred routed file with EC=A9 specified, the dayfile is 
copied to another file that the system queues for printing. 

11. All deferred routed files are queued for disposal. The files named OUTPUT, PUNCH, 
PUNCHB, and P8 are also queued for disposal in batch jobs. The system does not 
automatically queue files OUTPUT, PUNCH, PUNCHB, and P8 in interactive jobs.t 


tlhis step is done only if job output is to be queued. You can prevent the queueing of job 
output by specifying the appropriate parameter on the SETJOB, ROUTE, SUBMIT, or LDI 
command. 
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PROCEDURES 


4 


A NOS procedure is a sequence of NOS commands, residing in a separate record or file, that 
performs a specific task or sequence of tasks. A procedure header directive identifies the 
file as a procedure file, and a number of other procedure directives allow you to control 
additional procedure processing options. 

Once you have created a procedure and stored it in a permanent file, the procedure is 
available to you at any future time. To execute the procedure, you must call the procedure 
using an appropriate form of the BEGIN command, which we describe later in this section. 
Procedures that you create yourself can be called from a local file, a permanent file 
(direct or indirect access), or from a local or global library set. Your site may also 
provide procedures of general use that you can call from system libraries or from user name 
LIBRARY. A procedure can be called from another procedure up to a maximum of 50 nested 
procedures. 

A procedure called from a batch job functions much like a program subroutine. You can pass 
parameters to the procedure on the procedure call (BEGIN command). The procedure accepts 
any data passed to it, performs its processing functions, and returns control to the calling 
job or procedure. 

When called from an interactive job, a NOS procedure functions like a user—defined system 
command. Once you have made the procedure file local to your job, you can execute the 
procedure simply by entering the procedure or file name, followed by any parameters you may 
have defined for the procedure. 

Although NOS supports both interactive and noninteractive procedure formats (noninteractlve 
procedures are also called passive procedures), any NOS procedure can be called from either 
a batch or interactive job. The Interactive procedure formats described in this section 
differ from the noninteractlve format (described in Appendix L) in that the interactive 
formats provide the end user with various types of interactive help and parameter prompts. 

The major features of NOS interactive parameter formats are: 


Two Interactive Formats 


As the procedure writer, you can choose between the parameter—prompting (*I) or the menu 
(*M) Interactive formats. The parameter-prompting format prompts the user to enter 
required parameter values. The menu format displays a list of possible parameter values 
and prompts the user to select one of the values by number. 


Procedure Prompting 


If the user falls to enter a required parameter value, or enters an invalid value, the 
system prompts the user to enter a correct value. 
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Interactive Help 


Both interactive formats give the user easy access to system-generated, as well as 
procedure-defined help for a procedure and its parameters. 


Parameter Validation 


The interactive formats provide an easy way of defining the types of parameter values 
that can be entered for any particular parameter. The system will not execute an 
interactive procedure until the user has entered a valid value for each required 
parameter. 


PROCEDURE FILE RESIDENCE AND SEARCH ORDER 

A procedure is stored as a separate record on a file. Several procedures, or a collection 
of procedures and programs, can exist on the same file. Procedures can be stored on local 
files. Indirect access or direct access permanent files, system libraries, or user name 
LIBSARY. Procedures can also reside on magnetic tape as well as mass storage. 

The procedure search order is dependent on the form of the BEGIN command used to call the 
procedure. For more information on the search order, refer to the BEGIN command description 
in this section. 


PROCEDURE STRUCTURE 

A procedure file can be divided into five sections, as shown by the example in Figure A-1. 
The first four sections comprise the procedure itself (the procedure begins with the 
procedure header (.PROG) directive and ends with a REVERT command at the end of the command 
section). The fifth (Data) section may contain progr 2 ims, procedures, or other data to be 
referenced by the procedure. 

The first line or lines of a procedure is the procedure header, which consists of a single 
procedure header (.PROG) directive. The procedure header names the procedure. Indicates 
whether the system will prompt for required parameter values, defines what the prompts will 
consist of, and defines any restrictions on the types of values that can be entered for each 
parameter. The .PROG directive and all other procedure directives are listed in summary 
form in Table 4-1 and are described in detail under Procedure Directives in this section. 
Procedure directives are identified by the period (.) before the directive name. 

The formatting section contains directives which alter the default text and format of user 
prompts. This section of the procedure body is optional, as the system does provide default 
text and format for all prompts. If you do specify directives in this section, the 
formatting directives must Immediately follow the procedure header directive. 

The help section contains directives and text which define the help to be provided for 
procedure parameters and for the procedure itself. This section of the procedure is 
optional, as the system can generate help from the information in the procedure header. If 
you do specify any directives in this section, you must include a .ENDHELP directive to end 
the section. 
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.PR0C,TESTPN*I 
xPN"Enter project number"= 

• Procedure Header 

(*S10(ABCDEFGHIJKLMN0PQRSTUVWXYZ$/$1234567890)). 
.NOCLR,Executing - Please wait. 

Formatting Section 

.HELP 

TESTPN requests that you enter a valid 
project number for this application. 

.HELP,PN 

Help Section 

Enter a project number 

(Maximum of 10 characters) 

.ENDHELP. 

.IF,$PM$.NE.$PRJ/2201$,LABEL1. 


NOTE./INVALID PROJECT NUMBER/ 

REVERT,N0LIST. 

.ENDIF,LABEL1 . 

RETURN,LISTFIL,LGO. 

Command Section 

FTN5,1=APPL,L=LISTFIL,B=LG0. 

LGO. 

REVERT,NOLIST. 

EXIT. 

REVERT,ABORT.TESTPN 
.DATA,APPL. 

PROGRAM APPL 

PRINT*,’APPL COMPLETE' 

Data Section 

END 



Figure A-1. Procedure File Structure 


The command section consists of procedure directives and system commands you want to be 
executed. Most system commands are allowed within a procedure. The exceptions are 
primarily the commands restricted to entry from interactive terminals (refer to section 8). 

The data section consists of infomation you want written to a local file or files so that 
you can reference it while the procedure executes. You can also reference the data section 
in the procedure header. A separate .DATA directive identifies each local file to be 
created. 


PROCEDURE PROCESSING 

The system performs interactive procedure processing in three stages: 

• Interactive parameter entry 

• Procedure expansion 

• Execution of the command record 
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INTERACTIVE PARAMETER ENTRY 


During interactive parameter entry, the system processes the procedure header directive and 
all directives in the formatting and help sections. 

The system prompts the user for all required parameter values as specified in the procedure 
header. Each value the user enters is verified against the validation requirements 
specified in the procedure header. If any value fails to meet the validation requirements, 
the system prompts the user to enter a corrected value. 

The correction prompt and other interactive prompts can be modified by directives in the 
formatting section. 

If the user requests help for the procedure or for a parameter (by entering a ? following 
the procedure call or following a parameter prompt), the system displays the applicable 
system default help text, if any, followed by procedure-defined help text. 

The interactive parameter entry portion of procedure processing is completed when the user 
enters a carriage return after having correctly entered all required parameter values. If 
the user correctly enters all required values on the procedure call, no formatting or help 
directives (except .NOTE and .NOCLR) are processed, and procedure expansion begins 
immediately. 


PROCEDURE EXPANSION 

Procedure expansion is performed only on the procedure command and data sections. During 
procedure expansion, the system: 

• Processes all directives in the command and data section. 

• Substitutes parameter values specified by the user, or by the ,PR0C directive, for 
each occurrence of the corresponding parameter keyword in the command and data 
sections. 

• Creates a scratch file, called the procedure command record, which contains the NOS 
commands from the procedure command section as modified by directive processing and 
parameter substitution. 

• Creates a separate local file for each .DATA directive processed during expansion of 
the procedure. 

At completion of expansion processing, the calling user's job has assigned to it a scratch 
file (the procedure command record), containing NOS commands ready to be executed, and a 
local file for each .DATA file referenced in the command record. 

The procedure command record created during expansion processing is simply the sequence of 
NOS commands to be executed. Although procedure directives are used to define and create 
the command record, directives themselves do not appear in the command record since they are 
not executable system commands. 

The procedure command record may not include all system commands from the procedure command 
section. This is determined by processing of the .IF, .ELSE, and .ENDIF directives. The 
.IF directive functions similarly to the IF command. In the same way that the IF command 
determines whether the following sequence of commands will be executed, the .IF directive 
determines whether the following sequence of commands is written to the procedure command 
record. In other words, if the expression in the .IF directive is true, the commands placed 
between .IF and .ELSE or .ENDIF are written to the command record; if the expression is 
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false, these same commands are not written to the command record. To see the results of the 
•IF directive, look at figures 4—2 and 4—3. These figures show the command records 
resulting from valid and invalid entries for the procedure in figure 4-1. 

Note that at the end of processing in either figure 4-2 or 4-3, a listing of the user's 
local jobs would show a file called APPL. This file is created as a result of the .DATA 
directive in procedure TESTPN from figure 4-1. 


Procedure Command record: 

RETURN,LISTFIL,LGO. 

FTN5,I=APPL,L=LISTFIL,B=LG0. 

LGO. 

REVERT,NOLIST. 

Dayfilet 

testpn,prj/2201 
APPL COMPLETE 
/dayfiLe/fr=testpn,op=m 

10.18.53. TESTPN,PRJ/2201. 

10.18.54. RETURN,LISTFIL,LG0. 

10.18.55. FTN5,I=APPL,L=L1STFIL,B=LG0. 

10.18.55. 62700 CM STORAGE USED. 

10.18.55. 0.009 CP SECONDS COMPILATION TIME. 

10.18.55. LGO. 

10.18.56. END APPL 

10.18.56. 14300 MAXIMUM EXECUTION FL. 

10.18.56. 0.007 CP SECONDS EXECUTION TIME. 

10.19.21.DAYFILE,FR=TESTPN,0P=M 
USER DAYFILE PROCESSED. 

/ 


Figure 4-2. TESTPN with Valid Entry 


Procedure Command record: 

NOTE./INVALID PROJECT NUMBER/ 

REVERT,NOLIST. 

Dayflie: 

testpn,888 

INVALID PROJECT NUMBER 

/dayfiLe,fr=testpn,op=ra 

10.19.51. TESTPN,888. 

10.19.51. NOTE./INVALID PROJECT NUMBER/ 
10.20.03.DAYFILE,FR=TESTPN,OP=M 

USER DAYFILE PROCESSED, 

/ 


Figure 4-3. TESTPN with Invalid Entry 
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Following are some tools you can use to further control procedure expansion: 


• .EXPAND Directive 

• Inhibit Character 

• Concatenation Character 

• .EX Directive 


.EXPAND Directive 

The .EXPAND directive allows you to suspend expansion processing for one or more lines of a 
procedure. Inserting a .EXPAND,OFF directive suspends directive processing and parameter 
substitution for subsequent lines of the procedure until the end of the procedure or until a 
.EXPAND,ON directive appears. 

An especially useful application of the .EXPAND directive is to inhibit expansion of a 
procedure in a .DATA file. Normally, calling a procedure file initiates expansion of the 
entire file, including the data section. However, if the data section contains another 
procedure file, you may not want the .DATA file to be expanded until it is called by a BEGIN 
command. Inserting a .EXPAND,OFF directive before the .DATA directive prevents the creation 
of the .DATA file. Inserting a .EXPAND,OFF directive immediately after the .DATA directive 
causes the .DATA file to be created but remain unchanged by expansion of the original 
procedure. 


inhibit Character 

Like the EXPAND directive, the inhibit character also inhibits parameter substitution or 
directive processing during procedure expansion. In general, the scope of the inhibit 
character is more limited than that of the EXPAND directive. The default inhibit character 
is # (or = if you are using a CDC graphic character set). You can define a different 
inhibit character using the .IC directive. 

Usage rules for the inhibit character are: 

• The inhibit character placed before a parameter keyword in the command or data 
section inhibits substitution of that keyword. 

• The inhibit character placed before a procedure directive (including a .DATA 
directive) in the command or data section inhibits expansion processing of that 
directive. 

• The inhibit character placed before a concatenation character inhibits processing of 
the concatenation operation; the concatenation character remains intact. In this 
case, the inhibit character does not prevent parameter substitution of a keyword 
following the concatenation character. 

• The inhibit character placed before a second inhibit character causes the second 
inhibit character to remain intact and not be recognized as an inhibit character. 

In this case, parameter substitution of a keyword following the second inhibit 
character is not prevented. 
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• Expansion processing strips all inhibit characters from the procedure command record 
except for those appearing in a sequence of two or more inhibit characters. When 
they appear in sequence, only the odd numbered inhibit characters in the sequence 
are acted upon and omitted from the procedure command record. 

The inhibit character is often used to allow use of the same character string for both a 
parameter keyword and value. For example, if an input file parameter is written as #1=1, 
procedure expansion removes the #, leaves the first I intact, and performs normal 
substitution on the second I. 

If a keyword or directive is subject to expansion processing more than once, you can control 
when it is processed by inserting one or more inhibit characters before the keyword or 
directive. In the following example, expansion of procedure PROCl creates one local file 
called DATAl and strips the # from the second .DATA directive. Since the # character is no 
longer present when PR0C2 is executed, PR0C2 expansion creates local file DATA2. 

.PR0C,PR0C1*I. 


REVERT. 

.DATA,DATA1. 
.PR0C,PR0C2*I. 


REVERT. 

#.DATA,DATA2 


Following is an example of inhibit character usage. 

In this example, procedure INHIBIT resides on file PROCFIL. 

.PROC,INHIBIT*I,I=(*N=TEST). 

GET,I. 

FTN5,#I=I,L=0 

LGO. 

COMMENT. I, #1, I#I, #I#I. 

If procedure INHIBIT is called by the command: 
begin,inhibit 


The resulting dayfile segment is: 

10.31.OO.BE6IN,1NHIBIT. 

10.31.00.6ET,TEST. 

10.31.00.FTN5,I=TEST,L=0 

10.31 .(M. 56000 CM STORAGE USED. 

10.31.00. 0.011 CP SECONDS COMPILATION TIME. 

10.31.00.LGO. 

10.31.01. STOP 

10.31.01. 5600 FINAL EXECUTION FL. 

10.31.01 0.000 CP SECONDS EXECUTION TIME. 

10.31.01.COMMENT. TEST, I, TESTI, II. 

10.31.01.SREVERT.CCL 
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Concatenation Character 

The concatenation character allows parameter substitution for a substring of a character 
string. When explicit expansion is in effect, the concatenation character also enables 
parameter substitution for a keyword that immediately follows the character. The default 
concatenation character is _ (or f”*" if you are using a CDC graphic character set). 

Usage rules for the concatenation character are: 

• Expansion processing removes all concatenation characters from the procedure file 
except those included in a $-delimited literal string and those preceded by a # 
character. 

• After removal of a concatenation character, the preceding and following character 
strings are concatenated by shifting the remainder of the line one character to the 
left. For example, if PROG is a parameter keyword for which the user enters a value 
of NEW, the string PROG_B becomes NEWB after expansion processing. 

Following is an example of concatenation character usage. 

Procedure LINK resides on file FlLEl. 

.PR0C,LINK*I,SUFFIX"F0R C0PY"=(*N=,BF,BR,CF,CR,EI,SBF,X),LFN1=(*F),LFN2=(*F). 
REWIND,LFN1. 

C0PY_SUFFIX,LFN1,LFN2. 

In the following example, the first BEGIN command does a COPYSBF of file PLAN to file 
SCHEME. The next BEGIN command does a COPYEI of file MAZE to file TAXES. Each resulting 
dayfile follows the BEGIN command. 

begin,link,fi1e1,suf fix=s bf,Ifnl=plan,Ifn2=s cheme. 

08.00.17.$BEG1N^LINK,FILE1^SUFF1X=SBF,LFN1*PLAN^LFN2=SCHEME. 

08.00.18.REUIND^PLAN. 

08.00.18.COPYSBF,PLAN,SCHEHE. 

08.00.18. EOI ENCOUNTERED. 

08.00.18.$REVERT.CCL 

begin,link,file1,suffix=ei,Ifnl=ma 2 e,Ifn2=taxes. 

08.03.23.$BEGIN,LINK,FILE1,SUFFIX=EI,LFN1=MAZE,LFN2=TAXES. 

08.03.23.REWIND ^NAZE. 

08.03.2A.C0PYEI,MAZE,TAXES. 

08.03.24. EOI ENCOUNTERED. 

08.03.24.$REVERT.CCL 
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.EX Directive 


The .EX directive immediately terminates expansion processing and executes the command 
included in the directive. No further expansion processing is perfornted, and the procedure 
command record is not executed. 

The most common use of .EX is to initiate immediate processing of a menu procedure option as 
shown in the following example; 

.PROC,APROC*H 

,PAra»l= 

<1"0PT1", 

2"0PT2", 

3"0PT3"). 

.EX.BEGIN,PARH,LIBFILE. 

EXECUTION OF THE COMMAND RECORD 

At completion of expansion processing, the system increments the procedure nesting level 
count and begins execution of the procedure command record. 

When all commands in the procedure command record have been processed, the system executes a 
system- or user—supplied REVERT command, decrements the procedure nesting count, and returns 
control to the calling job or procedure. 


PROCEDURE DIRECTIVES 


Procedure directives have these general syntax features; 

• They all have a period as a prefix character. 

• You can use a comma or an opening parenthesis as a separator within directives. 

• You can use a period or a closing parenthesis as a terminator. You must use a 

period or closing parenthesis as a terminator if you append comments to the 
directive. 

• A procedure directive can span more than one line. No line can contain more than 

150 6-bit characterst and each line to be continued must either end with a nonblank 

separator or the succeeding line must begin with a nonblank separator. 

• Unless otherwise stated, the system reads the characters you enter in directives as 
6-bit display code (uppercase characters only). You can enter the text for help 
information and prompts in uppercase and lowercase characters (6/12-bit display 
code). 


tThis value can be changed during Installation. 


60459680 J 


4-9 



The detailed descriptions of the procedure directives later in this section include any 
exceptions to the general syntax features just cited. 

Procedure directives can be grouped by function into six basic types. The directives are 
listed by type in table 4-1. 


Table 4-1. Procedure Directives 


Directive Type 

Directive 

Function 

Procedure header 

.PROC 

Specifies the procedure name, defines parameters, and 
enables parameter prompting. 

Formatting 

.CORRECT 

Specifies the prompt to follow an incorrect parameter 
entry. 


.ENTER 

Specifies the prompt to appear before a parameter entry 
is made. 


.Fn 

Specifies a label for programmable function key Fn. 


.NOCLR 

1 

Inhibits the automatic clearing of the screen while the 
procedure executes. 


.NOTE 

Specifies a message to appear on the screen while the 
procedure executes. 


.PAGE 

Specifies the string to precede the page number on the 
screen. 


.PROMPT 

Specifies the text for the general request for input. 

Help 

.ENDHELP 

Marks the end of the help section of the procedure. 


.HELP 

Specifies help text for the procedure or a parameter. 

Expansion 

.CC 

Specifies the concatenation character to be used in the 

Control 


procedure body. 


.ELSE 

Terminates skipping initiated by a matching .IF or 
.ELSEIF, or initiates skipping until a matching .ENDIF 
is found. 


.ELSEIF 

Initiates skipping until a matching .ENDIF is found or 
terminates skipping initiated by a matching .IF and 
tests for further conditional expansion of the 
procedure body. 


.ENDIF 

Terminates skipping initiated by a matching .IF or 
.ELSE. 


.ENDW 

Terminates skipping initiated by a matching .WHILE or 
initates a search for a preceding matching .WHILE. 


.EX 

Submits a single coEimand to the system for immediate 
execution. 


.EXPAND 

Terminates or restores procedure expansion for 
subsequent lines of the procedure. 


.IF 

Allows conditional expansion of the procedure body. 


.IC 

Specifies the inhibit character to be used in the 
procedure body. 


.WHILE 

Allows iterative conditional expansion of the procedure 
body. 

File 

.DATA 

Creates a local file. 


.EOF 

Inserts an end-of-file mark in a (.DATA) file created 
by the procedure or in the procedure command record. 


.EOR 

Inserts an end-of-record mark in a (.DATA) file created 
by the procedure or in the procedure command record. 

Comment 

.* 

Identifies comments in the procedure. 
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PROCEDURE HEADER (.PROC) Directive 


Every procedure begins with a procedure header (.PROC) directive. The .PROC directive names 
the procedure, controls parameter prompting, and defines any restrictions on values that can 
be entered for the parameters. 

The .PROC directive must be the first line of the procedure and must begin in column 1. It 
can be continued on one or more succeeding lines by ending the continued line, or beginning 
the continuation line, with a non-blank separator character. The .PROC directive must end 
with a period (.). 

This section describes the interactive and menu formats of the .PROC directive. The 
noninteractive format is described in appendix L. 


Interactive Format 


This directive enables interactive processing of a procedure call (refer to Requesting Help 
on Procedure Calls later in this section). The directive: 

• Designates procedure parameters as optional or required. 

• Designates permissible values and correct syntax for each parameter through a 
checklist. 

• Describes each parameter to be used in prompting the procedure caller. 

Format: 

.PROC,pnarne*!”title",pi,p 2 ,...,pn.ck. 

Parameter Description 


pname Specifies the procedure name, pname can be one to seven alphanumeric 

characters. The procedure name should begin with an alphabetic 
character. You must append *1 to the procedure name to enable 
parameter prompting. 

title Specifies the procedure title. The system assumes that your title is 

in 6/12-bit display code, which supports uppercase and lowercase 
characters. The title string can be a maximum of 40 lowercase 
(12-bit) characters, 80 uppercase (6-bit) characters, or any 
combination of lowercase and uppercase characters that does not exceed 
480 bits. The title field can be null ("") or omitted. If omitted, 
the default title used in the screen mode parameter display is the 
procedure name pname. 

The system displays the title whenever the procedure is called and 
required parameters are not supplied. 
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Description 


Parameter 


Pi Specifies optional parameters. The maximum number of parameters is 

50. Each parameter pj has the following form: 

keywrd"de script ion''= ( checkl i s t) 
or 

keywrd'description'=(checklist) 

keywrd Specifies the keyword of the parameter. ke 3 rwrd 

can be a string of 1 to 10 alphanumeric 
characters. The occurrences of keywrd in the 
procedure body are replaced by a value that 
conforms to the specifications made in the 
checklist. This value is specified by a 
parameter on the procedure call or by default 
according to checklist specifications .t“ 

If keywrd is surrounded by dollar signs 
($keywrd$), any dollar symbols that surround or 
are contained within the parameter value are 
retained as a part of the value. Note that when 
the user is prompted for the value in screen mode, 
the value entered is treated as a literal value 
even if it is not surrounded by dollar symbols. 

If the specified value is not surrounded by dollar 
signs, the system converts it to a literal format 
(by appending prefixing and suffixing dollar signs 
and replicating any dollar signs that occur within 
the value) before substituting the value in the 
body of the procedure. 

description Specifies an optional text string that the system 
displays when prompting for a parameter. The 
title string can be a maximum of 40 lowercase 
(12-bit) characters, 80 uppercase (6-bit) 
characters, or any combination of lowercase and 
uppercase characters that does not exceed 480 
bits. In screen mode, the system displays a 
maximum of 40 characters. The description field 
may be null or omitted. 

You must enclose the text string in quotation 
marks or apostrophes. If you use quotation 
marks, the default prompt for the parameter p^ 
has the following format: 

Enter keywrd description? 

If you use apostrophes, the system uses only your 
description string in the prompt: 

description? 

Two examples of these prompting formats appear 
under the description of the .HELP directive. 

tThere is a seven-character restriction on the length of the keyword if the name call 
format of the BEGIN command is to be used, the keyword is to be specified on the call, or 
the procedure is a local file. 
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Parameter 


Description 


checklist Specifies a list of the acceptable values and 
syntax for pj. The checklist must be enclosed 
in parentheses. The value specified for a 
parameter in a procedure call is compared to each 
of the entries in the checklist in left to right 
order and a match must occur for a value to be 
acceptable• If more than one match occurs, the 
first match determines the substitution. 

If the checklist is omitted, the system assumes 
that any 0- to 40-character value is valid. The 
detailed description of acceptable checklist 
entries is in the following paragraphs. 

ck Specifies a 1- to 10-character comment keyword. The keyword must be 

Immediately preceded and followed by periods with no intervening 
spaces. This is an optional parameter. The system substitutes 
comments specified on the procedure call for the comment keyword in 
the procedure body. The system substitutes a null value for the 
comment keyword if no comments are on the procedure call. If you do 
not specify a comment keyword, the system Ignores comments made on the 
procedure call. 

Note that the system treats the comment keyword ck as a contiguous 
string upon substitution. If ck is concatenated to another long 
string in the procedure body, this substitution could produce a line 
that exceeds the line length limit (150 6-bit characters). 


A comma must separate .PROC and the procedure name. The separator between the procedure 
name and the procedure parameters can be a comma, reverse slant (\), or slant (/). Reverse 
slants and slants have special significance as described under Parameter Matching Modes 
later in this section. 


CHECKUST ENTRIES 

Entries in the parameter checklist are of three types: simple values, equlvalenced values, 
and checklist patterns. A single checklist can contain any combination of entry types and 
multiple entries of the same type. 

A simple value is an entry of the form: 

pstrlng 

where pstrlng is any 0- to 40-character string. If pstring contains nonalphanumerlc 
characters other than asterisks (*), it must be enclosed in literal delimiters ($). 

A simple value specifies that if the user enters a value of pstrlng on the BEGIN command, 
pstring is substituted for the parameter keyword in the procedure body. 
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An equivalenced value is an entry of the form: 
pstring=pvalue 

where pstring and pvalue are 0- to 40-character strings. If either pstring or 
pvalue contains nonalphanumeric characters other than asterisks (*), it must be 
enclosed in literal delimiters ($). 

An equivalenced value specifies that if the user enters a value of pstring on the BEGIN 
command, pvalue is substituted for the parameter keyword in the procedure body. 

There are several patterns that can be used in the checklist. Each pattern defines a set of 
restrictions to be placed on values entered by the user. The checklist patterns are 
summarized in figure 4—4 and are described in detail on the following pages • 

Most checklist pattern have three forms: 

*P 

*pS5 

*p=pvalue 

where p is a character identifying the checklist pattern and pvalue is any 0- to 
40-character string. If pvalue contains nonalphanumeric characters other than 
asterisks (*), it must be enclosed in literal delimiters ($). 

The *p form specifies that a parameter value entered by the user is substituted for the 
parameter keyword if the value meets the requirements defined by *p. 

The *p= form specifies that a null substitution occurs if the value entered by the user 
meets *p requirements. In other words, all occurrences of the parameter keyword are omitted 
from the procedure command record. 

The *p=pvalue form specifies that pvalue is substituted for the parameter keyword if the 
value entered by the user meets the requirements of the *p pattern. 


Special Values 

There are three special values that can be specified in an equivalenced value entry in a 
*p='pvalue checklist pattern. These special values are; 

Special Value Significance 


#DATA 


#FILE 

^PRIMARY 


Specifies the name of the local file created by an unlabeled .DATA 
directive (that is, a .DATA directive on which the Ifn parameter is 
omitted). Note that there can be no more than one unlabeled .DATA 
directive in a procedure. The actual file name used is ZZCCLAA, 
ZZCCLAB, ZZCCLAC, or so on, depending on the nesting level of the 
procedure. 

Specifies the file containing this procedure. 

Specifies the primary file. 
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i^necKiist 


Pattern 


Description 


*Ain. .nt 


*Ani. .n=t 
*Ain. .n=valuet 


Allows entry of any character string up to 40 characters. The 
string replaces ke 3 rword. 

Entry of character string causes a null substitution. 

Entry of character string replaces keyword with value. 


*Fin..nt 
*Fiii. .n=t 
*Fib. .n=valuet 


Allows entry of valid NOS file name. File name replaces keyword. 
Entry of a file name causes a null substitution. 

Entry of a file name replaces keyword with value. 


Allows keyword to be entered as a value. No substitution results. 
Entry of the keyword causes a null substitution. 

*K=value Entry of the ke 3 rword replaces keyword with value. 


*N or *D 
*N= or *D= 
*N“value 
or 

*D=value 


Specifies that parameter is optional. No substitution results. 
Specifies that omission of parameter causes null substitution. 
Specifies a default value for the parameter. Omission of 
parameter replaces keyword with value. 


*Pm..nt 


*Pm..n=t 
*Pm..n=valuet 


Allows entry of a valid NOS file name that does not begin with a 
digit. The file name replaces keyword. 

Entry of a file name causes a null substitution. 

Entry of a file name replaces keyword with value. 


Specifies a restricted parameter whose values are not displayed in 
the dayfile. Substitution is not affected. 


*Sm..n(chars)t 
or 

*Sm..n/kt 


Allows entry of any characters selected from chars or from the set 
represented by k. These characters replace ke 3 rword. 
chars defines all allowable alphanumeric or special characters, 
k can be any of the following mnemonic abbreviations: 

A Any alphabetic characters 

B Any octal characters 

D Any decimal characters 

AB Any alphabetic and octal characters 

AD Any alphabetic and decimal characters 

To Include an asterisk (*) as a member of the set, append an 
asterisk to the mnemonic. For example, D* specifies any decimal 
character and * as allowable characters. 


*Sm..n(chars)=t 

Entry of 

or 


*Sm..n/k=t 


*Sm..n(chars)“valuet 

Entry of 

or 


*Sm..n/k=valuet 


pstring 

Entry of 

pstring” 

Entry of 

pstring“pvalue 

Entry of 


allowable characters causes a null substitution. 


allowable characters replaces keyword with value. 


string pstring replaces keyword with pstring. 
string pstring causes a null substitution, 
string pstring causes pvalue to replace keyword. 


tThe specification m..n is optional and defines the minimum and maximum length of the 
character string or file name that can be entered for the parameter value. Valid ranges 
are 0 to 40 for *A, 1 to 7 for *F and *P, and 1 to 40 for *S. If only a single length 
value is specified, it is assumed to be the maximum. For example, *A10 allows entry of 
any string from 0 to 10 characters long. 


Figure 4-4. Summary of Checklist Entries 
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Checklist Patterns 

Checklist Pattern 

*Ain. •n=value 
*Ain. .n= 

*Am..n 


*Ftn. .n=value 
*Fm..n= 

*Fm..n 


Description 


Specifies the substitution for keywrd regardless of the specifica¬ 
tions for pj_ on the procedure call. Tn..n specifies the minimum 
and maximum values for the length of the entry on the procedure 
call. The default value for m is 0 and for n is 40. The maximum 
value for n is 40. If *Am..n=value is in the checklist, value 
replaces keywrd in the procedure body regardless of what is 
specified on the procedure call. 

You can specify any string of 0 to 40 uppercase characters for 
value. You must delimit special characters, other than asterisks 
(*), with dollar signs. 

If value is //DATA, all occurrences of keywrd in the procedure body 
are replaced by the name of the data file created by the .DATA 
directive (refer to .DATA Directive for the name of this file). If 
value is //FILE, all occurrences of keywrd in the procedure body are 
replaced by the name of the file that contains the procedure. Any 
data read from this file begins with the record immediately 
following the record that houses the procedure. If the procedure 
resides on a library and is called by a name call form of the BEGIN 
command, kejrwrd is replaced by a null value. If value is ^PRIMARY, 
all occurrences of keywrd in the procedure body are replaced by the 
current primary file. 

If *Am..n= is in the checklist, a null value replaces keywrd. If 
*Am..n is specified, whatever is specified on the procedure call 
replaces keywrd. 

If you specify some form of the *A entry more than once in a single 
checklist, the system uses the leftmost entry. 

Example: 

.PROC,EBOC*I,P1=(*A5),P2=(*A10..15),P3=(*A20..). 

In this procedure header directive, PI allows entry of a character 
string 0 to 5 characters long, P2 allows a string 10 to 15 
characters long, and P3 allows a string 20 to 40 characters long. 

Specifies that the parameter entry for pj^ on the procedure call be 
a file name that conforms to the operating system format for a local 
file name. m..n specifies the minimum and maximum length of the 
file name. The default value for m is 1 and for n is 7. If 
*Fm..n=value is in the checklist, value replaces keywrd in the 
procedure body when a file name is specified on the procedure 
call. You can specify any 0- to 40-character string for value. 

You must delimit special characters, other than asterisks (*), with 
dollar signs. 
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Checklist Pattern 


Description 


*K=value 

*K= 

*K 


If value is #DATA, all occurrences of keywrd in the procedure body 
are replaced by the name of the data file created by the .DATA 
directive (refer to .DATA Directive for the name of this file). If 
value is #FILE, all occurrences of keywrd in the procedure body are 
replaced by the name of the file that contains the procedure. Any 
data read from this file begins with the record immediately 
following the record that houses the procedure. If the procedure 
resides on a library and is called by a name call form of the BEGIN 
command, keywrd is replaced by a null value. If value is ^PRIMARY, 
all occurrences of keywrd in the procedure body are replaced by the 
current primary file. 

If *Fm..n= is in the checklist, a null value replaces keywrd. If 
*Fm..n is specified, the file name specified on the procedure call 
replaces kejrwrd. 

If you specify some form of the *F entry more than once in a single 
checklist, the system uses the leftmost entry. 

Example: 

Procedure EXEC is on local file EXEC: 

.PR0C,EXEC*I,I=(*F4..7),B=C*N=LG0,*F),L=(*F=0UTPUT). 
FTN5,#I=1,#B=B,#L=L. 

EXEC is called: 

EXEC,I=CARDS,L=PRINT. 

The procedure body becomes: 

FTN5,I=CARDS,B=LGO,L=OUTPUT. 

Specifies the substitution for keywrd when the parameter entry for 
Pi on the procedure call is only the keyword keywrd or if the 
keyword is entered in response to an interactive prompt. If 
*K=value is in the checklist, value replaces keywrd in the 
procedure body. You can specify any striiig of 0 to 40 uppercase 
characters for value. You must delimit special characters, other 
than asterisks (*), with dollar signs. 

If value is #DATA, all occurrences of keywrd in the procedure body 
are replaced by the name of the data file created by the .DATA 
•directive (refer to .DATA Directive for the name of this file). If 
value is #FILE, all occurrences of keywrd in the procedure body are 
replaced by the name of the file that contains the procedure. Any 
data read from this file begins with the record immediately 
following the record that houses the procedure. If the procedure 
resides on a library and is called by a name call form of the BEGIN 
command, keyword is replaced by a null value. If value is 
^PRIMARY, all occurrences of keywrd in the procedure body are 
replaced by the current primary file. 
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Checklist Pattern 


Description 


If *K= is in the checklist, a null value replaces ke 3 rMrd. If *K is 
in the checklist, no substitution occurs. 

Specifying some form of the *K entry more than once in a single 
checklist is an error. However, you can specify another pattern 
chat is equivalent. Refer to procedures SUBNl and SUBN2 in the 
following examples. 

Examples: 

Procedure KEY is on local file PROCFIL. 

.PR0C,KEY*I,P1=(*K),P2=(*K=X),P3=(*K=). 

COMMENT. #P1=P1, #P2=P2, #P3=P3 

KEY is called: 

BEGIN,KEY,,P1,P2,P3. 

The procedure body becomes: 

COMMENT. P1=P1, P2=X, P3= 

The following calls to procedures SUBNl and SUBN2 illustrate the 
left-to-right Checking of the checklist and the use of equivalent 
patterns. Procedures SUBNl and SUBN2 are on local files by those 
same names and have the following lines, respectively: 

.PR0C,SUBN1*1,P1=(*K=KEYW0RD,P1=STRING,*N=DEFAULT). 

N0TE.+#P1»P1 

.PR0C,SUBN2*I,P1=(*N=I>EFAULT,P1=STRING,*K=KEYW0RD). 

N0TE.+#P1=P1 

Procedure SUBNl is called: 
subn1,p1 

The system writes: 

P1=KEYW0RD 

Procedure SUBN2 is called: 
subn2,p1 

The system writes: 

P1=STRING 
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Checklist Pattern 


Description 


A *K checklist pattern applies only when the kejTJord is entered by 
itself, or in response to an interactive prompt. It does not apply 
when an equivalence! value matching the keyword is entered as shown 
in the following call to procedure SUBNl: 

subn1,P1=p1 

The system writes: 

P1=STRING 

Specifies the substitution for keywrd when there is no parameter 
entry for p£ on the procedure call. If *N=value or *D=value is 
in the checklist, value replaces keywrd in the procedure body. You 
can specify any string of 0 to 40 uppercase characters for value. 
You must delimit special characters, other than asterisks (*), with 
dollar signs. 

If value is #DATA, all occurrences of keywrd in the procedure body 
are replaced by the name of the data file created by the .DATA 
directive (refer to .DATA Directive for the name of this file). If 
value is #FILE, all occurrences of keywrd in the procedure body are 
replaced by the name of the file that contains the procedure. Any 
data read from this file begins with the record immediately 
following the record that houses the procedure. If the procedure 
resides on a library and is called by a name call form of the BEGIN 
command, keywrd is replaced by a null value. If value is #PRIMARY, 
all occurrences of keywrd in the procedure body are replaced by the 
current primary file. 

If *N* or *D“ is in the checklist, a null value replaces keywrd. 

If *N or *D is in the checklist, no substitution occurs. 

If no format of the *N or *D entry is in the checklist, pj is a 
required parameter and interactive prompting occurs when it is 
omitted from the procedure call. However, if the only entry in the 
checklist is a form of *N or *D, any value supplied for it on the 
procedure call is ignored and interactive prompting does not 
occur. Specifying some form of the *N or *D entry more than once 
in a single checklist is an error. 

Example: 

Procedure SUB is on local file PROCFIL. 

.PR0e,SUB*I,P1=(*N),PZ=<*N=X),P3=(*N=). 

COMMENT. #P1=P1, #P2=P2, />P3=P3, P4 

SUB is called: 

BEGIN^SUB. 

The procedure body becomes: 

COMMENT. P1=P1, P2=X, P3=, P4 


*N“value 
*N= 

*N 

*D=value 

*D= 

*D 
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Checklist Pattern 


*Pin. .n=value 
*Pm..n“ 

*Pin. .n 


Description 

*N and *D values are displayed under different conditions. *D 
values are always displayed when screen mode Interactive prompting 
is required and a non-null value has not been entered for the 
parameter. *D values are always accepted if entered. values 
are displayed in screen mode only when they are valid according to 
another checklist pattern which has no replacement value. If an *N 
value matches more than one checklist pattern, the first checklist 
pattern determines whether the value is displayed. 

Specifies that the parameter entry for pj on the 
procedure call may be a file name that does not begin 
with a digit and that conforms to the operating system format for a 
local file name. m..n specifies the minimum and maximum length of 
the local file name. The default value for m is 1 and for n is 7. 
If *Pm..n=value is in the checklist, value replaces keywrd in the 
procedure body when a file name is specified on the procedure 
call. You can specify any 0- to 40-character string for value. 

You must delimit special characters, other than asterisks (*), with 
dollar signs. 

If value is #DATA, all occurrences of keywrd in the procedure body 
are replaced by the name of the data file created by the .DATA 
directive (refer to .DATA Directive for the name of this file). If 
value is #FILE, all occurrences of keywrd in the procedure body are 
replaced by the name of the file that contains the procedure. Any 
data read from this file begins with the record immediately 
following the record that houses the procedure. If the procedure 
resides on a library and is called by a name call form of the BEGIN 
command, keywrd is replaced by a null value. If value is ^PRIMARY, 
all occurrences of keywrd in the procedure body are replaced by the 
current primary file. 

If *Pm..n- is in the checklist, a null value replaces keywrd. If 
*Pm..n is specified, the file name specified on the procedure call 
replaces keywrd. 

If you specify some form of the *P entry more than once in a single 
checklist, the system uses the leftmost entry. 

Example: 

Procedure EXEC is on local file EXEC: 

.PR0C,EXEC*I,I=(*P4..7),B=(*N=LG0,*P),L=(*P=0UTPUT). 

FTN5,#I=I,#B=B,#L=L. 
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EXEC is called: 


EXEC,I=CARDS,L=PR1NT. 

The procedure body becomes: 

FTN5,I=CARDS,B=LG0,L=0UTPUT. 

Specifies that the parameter entry for p^ on the procedure 
call is restricted and is not to be displayed in the job or 
system dayfiles. Vnien *R is part of the checklist, any value 
supplied for p^ is removed from the command before it is 
placed in the dayfile. 

*Sm..n(chars)=value Specifies that the parameter entry for pi on the procedure call 
*Sm..n(chars)= may consist of a string of characters selected (in any order) from 

*Sm..n(chars) the set of characters represented by chars or from the set of 

or characters represented by k. m..n specifies the minimim and 

*Sm..n/k=value maximum values for the length of the string entered on the 

*Sm..n/k= procedure call. The default for m is 1 and for n is 40. The 

*Sm..n/k maximum value for n is 40. chars represents a set of up to 40 

uppercase alphantimeric and/or special characters. Special 
characters other than asterisks must be $-delimited. k selects one 
of the following sets: 

k Characters 

A All alphabetic characters 

B All octal characters 

D All decimal characters 

AB All alphabetic and octal characters 

AB All alphabetic and decimal characters 

To include one or more asterisks as members of the set, append an 
asterisk to the mnemonic. For example, AB* specifies all 
alphabetic and octal characters and asterisks are allowed. 

If *Sm..n(chars)=value or *Sm..n/k=value is in the checklist, value 
replaces keywrd in the procedure body when 1 to n characters from 
chars are specified on the procedure call. You can specify any 
string of 0 to 40 uppercase characters for value. You must delimit 
special characters, other than asterisks (*), with dollar signs. 

If value is #DATA, all occurrences of keywrd in the procedure body 
are replaced by the name of the data file created by the .DATA 
directive (refer to .DATA Directive for the name of this file). If 
value is #FILE, all occurrences of ke 3 ^rd in the procedure body are 
replaced by the name of the file that contains the procedure. Any 
data read from this file begins with the record immediately 
following the record that houses the procedure. If the procedure 
resides on a library and is called by a name call form of the BEGIN 
command, keywrd is replaced by a null value. If value is ^PRIMARY, 
all occurrences of keywrd in the procedure body are replaced by the 
current primary file. 
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Checklist Pattern 


Description 


If *Sm..n(chars)= or *Sm..n/k= is in the checklist, a null value is 
substituted for keywrd. If *Sm..n(chars) or *Sm..n/k is in the 
checklist, the parameter entry for p^ on the procedure call 
replaces keywrd. 

Example: 

Procedure COPIL is on local file COPI: 

.PR0C,C0PIL*I,0"0LD FILE NAI1E‘'=(*F^*N=0LD), 

R"REPLACEHENT FILE NAME"={*F,*N=LGO), 

N"NEW FILE NAHE"=(*F,*N=NEW), 

L"LAST RECORD"={* F,*N=)^ 

F”FLAG’'=<*S4<ARTE> ,*N=) . 

COPYL,0,R,N,L,F. 

REVERT. 

COPIL is called: 

BEGIN,C0PIL,C0PI,0=0LD,R=M0DIFID, 

N=NEW,F=AE. 

The procedure body becomes: 

COPYL,OLD,MODIFID,NEW,^AE. 

Procedure COPIL will accept one to four letters for the F parameter. 

More than one set may be specified for a parameter. For example, 
procedure SET has two sets specified for the P parameter. 

.PR0C,SET*I,P=(*S3(ABC),*S3/D). 

Parameter entries could include P=BB, P=BCA, or P=901 but not 
P=XZY, P=AZ, P=P or P=A2. 


Null sets are not allowed. For example, all the set entries for PI 
in the following procedure header are in error. 

.PROC,ERROR*I,P1=(*S,*S(),*S3). 


60459680 H 


4-21 



Checklist Pattern 


Description 


Specifies the substitution for keywrd when the parameter entry for 
Pj^ on the procedure call matches pstring. pstring must be 0 to 40 
uppercase characters. Special characters must be $-delimited. If 
pstring=pvalue is in the checklist, pvalue replaces keywrd in the 
procedure body when pstring is specified on the procedure call. 

You can specify any string of 0 to 40 uppercase characters for 
pvalue. You must delimit special characters, other than asterisks (*) 
with dollar signs. 

If pvalue is //DATA, all occurrences of keywrd in the procedure body 
are replaced by the name of the data file created by the .DATA 
directive (refer to .DATA Directive for the name of this file). If 
pvalue is //FILE, all occurrences of keywrd in the procedure body 
are replaced by the name of the file that contains the procedure. 

Any data read from this file begins with the record immediately 
following the record that contains the procedure. If the procedure 
resides on a library and is called by a name call form of the BEGIN 
command, keywrd is replaced by a null value. If pvalue is 
//PRIMARY, all occurrences of keywrd in the procedure body are 
replaced by the current primary file. 

If pstring= is in the checklist, a null value replaces keywrd. If 
pstring is in the checklist, pstring replaces keywrd. 

Example: 

Procedure LABL on a global library file: 

.PROC,LABL*I,FN"FILE NAME"=(*F>, 

VSN "VSN OF TAPE"=(*A)^ 

WRITE "YES OR N0"*(YES=W,N0*R). 

LABEL,FN,#VSN=VSN,#PO=WRITE,WRITE. 

REVERT. 

Procedure LABL is called: 

LABL,FN=STATS,VSN=TAPE24,WRITE=N0. 

Procedure body becomes: 

LABEL,STATS,VSN=TAPE24,P0=R,R. 


Menu Format 

This format of the .PROC directive generates a menu when you call the procedure and make no 
menu selection, when you make an incorrect selection, or when you request help information 
(refer to Requesting Help on Procedure Calls). The presence of the NOLIST parameter on the 
.HELP directive suppresses the menu display when you request .HELP information. 


pstring=pvalue 

pstring= 

pstring 
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Format: 


•PROC,pname*M"title",keywrd=(selections).ck. 

Parameter Description 

pname Specifies the procedure name, pname must be a 1- to 7-character 

string of alphanumeric characters. Make the first character of pname 
an alphabetic character to avoid inadvertent editing of the primary 
file on name calls to procedures. You must append *M to pname to 
enable menu generation. 

title Specifies the menu title. The title string can be a maximum of 40 

lowercase (12-bit) characters, 80 uppercase (6-bit) characters, or any 
combination of lowercase and uppercase characters that does not exceed 
480 bits. The title field can be null ("") or completely omitted. If 
you omit title, the system uses the procedure name pname as the title 
when the procedure is called in screen mode. The title appears 
whenever the system displays the menu. 

keywrd Specifies the keyword in the procedure body for which the system 

substitutes one of the selections, keywrd can be a string of 1 to 10 
alphanumeric characters. 

selections Defines the menu selections. A maximum of 50 selections can be 

defined for a menu. The definitions must have the following format: 

numj^"descriptj^",... ,numjj"descriptjj" 

num^ Defines an integer number that identifies the menu 

selection in the screen display, num^^ can be any 
integer up to 10 digits in length. Menu selections 
appear in the screen display in the order they are 
defined in the .PROC directive, not necessarily in the 
order defined by the selection numbers. 

descriptj^ Describes the menu selection. The description can be 
a maximum of 40 lowercase (12-bit) characters, 80 
uppercase (6-bit) characters, or any combination of 
lowercase and uppercase characters that does not 
exceed 480 bits. In screen mode, the system will 
display a maximum of 40 characters. You can also 
specify a null description ("") or omit this field. 
This description appears whenever the system displays 
the menu. 

ck Specifies a 1- to 10-character comment keyword. This is an optional 

parameter. A period must follow the comment keyword. The system 
substitutes comments specified on the procedure call for the comment 
keyword in the procedure body. The system substitutes a null value 
for the comment keyword if no comments are on the procedure call. If 
you do not specify a comment keyword, the system ignores comments made 
on the procedure call. 

Note that the system treats the comment keyword ck as a contiguous 
string upon substitution. If ck is concatenated to another long 
string in the procedure body, this substitution may produce a line 
that exceeds the line length limit (150 6-bit characters). 
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A menu has the following format: 


title 

nutn^. descript^ 
nuni2* descript2 


num^,. descriptpi 

SELECT BY NUMBER OR TYPE Q TO QUIT? 

where title, num^^, and descriptj^ conform to the descriptions given them previously. You 
can specify the prompt for a selection using the .PROMPT directive. If you do not, the 
system uses a default prompt as just shown. Additionally, the system centers all lines when 
in screen mode. 

The Q option aborts the procedure call and initiates a search for an EXIT command in the 
procedure. If the procedure was called from another procedure, the EXIT commands in the 
calling procedure or procedures are also processed. 
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FORMATTING AND HELP DIRECTIVES 


Along with the procedure header, the formatting and help directives further define the 
parameter prompts and help information that appears at the terminal. The formatting 
directives, if present, must follow the procedure header. Comment directives (beginning 
with .*) may be interspersed among the formatting directives. Help directives and help text 
follow the formatting directives. Comment directives placed in the help section are 
considered a part of the help text. 


.CORRECT Directive 

The .CORRECT directive specifies the first field of the prompt that follows a set of 
incorrect parameter entries. When the system prompts the procedure caller for corrections 
to an incorrect entry, the prompt has the following three fields: 

text parameter descriptiont 

This directive specifies the text field. 

Format: 

.CORRECT,text. 

.CORRECT=text. 


Parameter Description 


text Specifies a 1- to 80-character text string that appears on the 

screen. The system interprets your string in 6/12-bit display code, 
which supports uppercase and lowercase characters. 

In the first format, any alphanumeric or special characters may be 
used except a period or right parenthesis (. or )). Special 
characters need not be enclosed in $ signs. 

In the second format, any characters may be used (including a period 
or right parenthesis), but special characters must be enclosed in 
$ signs. 

In screen mode, the default text string is: 

Please correct 

In line mode, the default string is: 

Correct 

In screen mode, if the prompt is too long, the system truncates the prompt and indicates the 
truncation with an ellipsis (no truncation occurs in line mode). You can suppress display 
of the parameter field of the prompt by using apostrophes rather than quotation marks around 
the description in the procedure header. In screen mode, the prompt appears left-justified 
on the top line of the screen. 

This directive does not apply to menu procedures. 


tThe description field does not appear in screen mode. 
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.ENDHELP Directive 


The .ENDHELP directive specifies the end of the help section of the procedure body. You 
must include an .ENDHELP directive if there are any help directives in the procedure. Only 
one .ENDHELP directive is allowed in a procedure. 

Format: 

.ENDHELP. 

•ENTER Directive 

The .ENTER directive specifies the text for the initial prompt for a parameter. When the 
system initially prompts the user for a parameter, the prompt has the following three fields: 

text parameter description 

This directive specifies the text field. 

Format: 

.ENTER,text. 

.ENTER=text. 

Parameter Description 

text Specifies a 1- to 80-character text string that appears on the 

screen. In the first format, any alphanumeric or special characters 
may be used except a period or right parenthesis (. or )). Special 
characters need not be enclosed in $ signs. 

In the second format, any characters may be used (including a period 
or right parenthesis), but special characters must be enclosed in 
$ signs. 

The system interprets your string in 6/12-bit display code, which 
supports uppercase and lowercase characters. The default for the 
screen mode is; 

Please enter 

The default for line mode is; 

Enter 

In screen mode, if the prompt is too long, the system truncates the prompt and indicates the 
truncation with an ellipsis (no truncation occurs in line mode). You can suppress display 
of the text and parameter fields of the prompt by using apostrophes around the description 
in the procedure header. In screen mode, the prompt appears left-justified on the top line 
of the screen. 

This directive does not apply to menu procedures. 
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.Fn Directive 

The .Fn directive specifies a label for one of the six programmable function keys (FI 
through F6) you can use with screen mode parameter displays. 

Format; 

.Fn,text. 

.Fn=text. 

where n is one of the integers 1 through 6. 

Parameter Description 

text Specifies a label string of not more than eight characters. You can 

specify lowercase and uppercase characters. 

In the first format, any alphanumeric or special characters may be used 
except a period or right parenthesis (. or )). Special characters need 
not be enclosed in dollar signs ($). 

In the second format, any characters may be used (including a period or 
right parenthesis), but special characters must be enclosed in 
dollar signs. 

The function and default label of each of the programmable function keys are given in table 
4-2. 


.F7 Directive 

The .F7 directive enables you to use function key 7 (F7) instead of the NEXT or RETURN key 
to execute screen mode parameter displays and menu selections. When you specify this 
directive, the system displays the F7 key along with the other programmable keys. If you do 
not label the key, the system labels it EXECUTE. 

Format: 


.F7. 

.F7,text. 

.F7=text. 

Parameter Description 

text Specifies a label string of not more than eight characters. You 

can specify lowercase and uppercase characters. 

If you enter the first format and omit text, EXECUTE is displayed 
(refer to table 4-2). 

In the second format, any alphanumeric or special characters may 
be used except a period or right parenthesis (. or )). Special 
characters need not be enclosed in dollar signs ($). 

In the third format, any characters may be used including a period 
or right parenthesis, but special characters must be enclosed in 
dollar signs. 
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Table 4—2. Programmable Function Keys for Procedures 


Key 

Default Label 

Function 

FI 

FWD 

Pages forward through screens of parameters or menu 
selections. 

F2 

BKW 

Pages backward through screens of parameters or menu 
selections. 

F3 

HELP FWD 

Pages forward through screens of .HELP text. 

F4 

HELP BKW 

Pages backward through screens of .HELP text. 

F5 

HELP 

Displays .HELP text at the bottom of the screen. 

F6 

QUIT 

Aborts the procedure call and initiates search for an 

EXIT command in the current procedure and (if nested) in 
the calling procedures. 

F7 

EXECUTE 

Initiates execution of the procedure if all required 
values are supplied. 


.HELP Directive 

The .HELP directive indicates that the text that follows is information about the procedure 
Itself or its parameters. The procedure caller can access this information by entering a 
question mark as a parameter in a procedure call or by appending a question mark to the 
procedure name or a parameter name. When the system encounters a question mark in a 
procedure call, it stops processing the call and starts help processing. Therefore, 
anything entered after the question mark is not read. Refer to Requesting Help on Procedure 
Calls later in this section. If specified, .HELP directives must immediately precede the 
.EHDHELP directive. 

Formats: 

.HELP. 

.HELP,,NOLIST. 

.H£LP,parm. 

.HELP,pans,NOLIST. 

Parameter Description 

NOLIST Suppresses display of scmie .HELP text during help processing. 

parm Specifies one of the pareuaeter keywords in an interactive procedure 

(*I) or specifies one of the menu selections (choice^) in a menu 
procedure (*M). 

The first and second formats indicate the text that follows the directive describes the 
procedure. For interactive procedures in line mode, the NOLIST parameter suppresses the 
display of a parameter list when the caller requests information about the procedure. For 
menu procedures, the NOLIST parameter suppresses the display of the menu in line mode. 

For interactive procedures, the third and fourth formats indicate the text that follows the 
directive describes the parameter associated with the keyword parm. The NOLIST parameter 
suppresses the display of acceptable parameter values as given in the parameter's checklist. 
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For menu procedures, the third and fourth formats indicate that the text following the 
directive describes the specified menu selection. The NOLIST parameter suppresses the 
display of the menu after the display of the .HELP text. 

The text information starts on the line following the .HELP directive. The text can span 
multiple lines and must end with either another .HELP directive or an .ENDHELP directive. 
Parameter substitution does not occur within the .HELP text. 

The system assumes that your .HELP text is in 6/12-bit display code, which supports 
uppercase and lowercase characters. In batch jobs, the system displays .HELP text in 
uppercase only. 


Interactive (*I) Help 


When you request help information about an interactive procedure, the system displays the 
following: 

• The text following the procedure's .HELP directive. 

• The parameters that follow the procedure name on the .PROC directive unless 
suppressed by the NOLIST parameter of the .HELP directive (.HELP,,NOLIST). 

• A prompt for a value. The prompt includes the descriptive string specified with the 
parameter in the .PROC directive. 

When you request information about a particular parameter of an interactive procedure, the 
system displays the following: 

• Parameter values that are acceptable according to the parameter's checklist (the 
presence of NOLIST on the parameter's .HELP directive suppresses the display of 
these values). 

• The text that follows the parameter's .HELP directive. 

• The current value, if any, of the parameter. 

• A prompt for a value. The prompt includes the descriptive string specified with the 
parameter on the .PROC directive. 


Menu (*M) Help 

When you request help information about a menu procedure, the system displays the following: 

• The text following the procedure's .HELP directive. 

• The menu unless suppressed by the NOLIST parameter of the .HELP directive 

(.HELP,,NOLIST). 

• A prompt for a menu selection. 

When you request information about a particular menu selection, the system displays the 
following: 

• The text following the .HELP directive for that menu selection. 

• The menu unless suppressed by the NOLIST parameter of the .HELP directive. 

• A prompt for a menu selection. 
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Line Mode Example: 

Procedure PRINT (on file PRINT) verifies that the selected file is local before it routes 
the file to a printer. 


["note I 

The .HELP text uses lowercase and uppercase 
characters. 


.PROC,PRINT*I,F"FILE NAHE"=(*F), 

DC'DISPOSITION CODE"=(*N=LP,LP,PR,LR,LS^LT). 

.HELP. 

This procedure routes a permanent file to the selected Line printer. 
.HELP,F. 

The name of the permanent file to be routed. 

.HELP,DC. 

The disposition code. DC accepts only the Line printer options. 
.ENDHELP. 

.IF,FILE(F,.NOT.LO),PF. 

GET,F. 

.ELSE,PF. 

REWIND,F. 

.ENDIF,PF. 

COPYSBF,F,Z. 

ROUTE,Z,#DC=DC. 

REVERT,NOLIST. 


To get a description of procedure PRINT, either append a question mark to the file name or 
enter a question mark as the first parameter. If PRINT is a local file, you can get such a 
description by entering any of the following: 

PRINT? 

PRINT,? 

BE6IN,PRINT,PRINT? 

BE6IN,PRINT,PRINT,? 


If PRINT is not local, enter any of the following; 

BE6IN,PRINT,PRINT? 

or 

BEGIN,PRINT,PRINT,? 

or 

GET,PRINT 

PRINT,? 

or 

GET,PRINT 
PRINT? 
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The following is a sample of the dialogue generated by the .PROC and .HELP directives: 
/'begin,print,print? 

This procedure routes a permanent file to the selected line printer. 
PARAMETERS FOR PRINT ARE F, DC 
ENTER F FILE NAME? ? 

ALLOWABLE VALUE(S) 

MUST BE A FILE NAME 

The name of the permanent file to be routed. 

ENTER F FILE NAME? datafil 
ENTER DC DISPOSITION CODE? ? 

ALLOWABLE VALUE(S) 

LP 

PR 

LR 

LS 

LT 

PARAMETER MAY BE OMITTED 

The disposition code. DC accepts only the line printer options. 

ENTER DC DISPOSITION CODE? pr 

To illustrate the effect of enclosing the description string for a parameter in apostrophes 
instead of quotation marks, we use the same procedure as in the previous example and replace 
the quotation marks with apostrophes: 

.PROC,PRINT*I,F'FILE NAME'=(*F), 

DC DISPOSITION CODE' = (*N = LP,LP,PR,LR,LS,LT). 

Note the difference in the prompts. 

/begin,print,print? 

This procedure routes a permanent file to the selected line printer. 
PARAMETERS FOR PRINT ARE F, DC 
FILE NAME? ? 

ALLOWABLE VALUElS) 

MUST BE A FILE NAME 

The name of the permanent file to be routed. 

FILE NAME? datafil 
DISPOSITION CODE? ? 

ALLOWABLE VALUE(S) 

LP 

PR 

LR 

LS 

LT 

PARAMETER HAY BE OMITTED 

The disposition code. DC accepts only the line printer options. 

DISPOSITION CODE? pr 
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Screen Mode Example; 

If you are at a terminal supported by the full-screen display products and your terminal is 
in screen mode, the system can use full-screen displays to prompt you for parameters and to 
provide you with help information. 

The following screen results if you call procedure PRINT (as defined in the previous 
example); 



If you press the HELP key while the cursor is positioned in the input field for first 
parameter, you get the following screen; 
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If you press the HELP key while the cursor is positioned in the input field for the second 
parameter, you get the following screen: 



To get help information about the procedure itself, you can append a question mark to the 
name of procedure on the call or press the HELP key again after you get help for any of the 
parameters. 



Refer to Volume 2 for a detailed description of calling procedures in screen mode. 
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.NOCLR Directive 


The .NOCLR directive inhibits the system from automatically clearing the screen at the end 
of the procedure call (once all required parameters are supplied). You can also specify a 
message to appear at the top of the screen. Unless specified to do otherwise, the system 
clears the screen at the end of the call, and the screen is blank until the procedure 
completes execution or sends output to the terminal. 

The .NOCLR directive must be placed before any .HELP directives in the procedure. 

Format: 

.NOCLR,message. 

.NOCLR=message. 

Parameter Description 

message Specifies a 1- to 40-character text string that appears at the top of 

the screen. You can use uppercase and lowercase characters in the 
string. 

In the first format, any alphanumeric or special characters may be 
used except a period or right parenthesis (. or )). Special 
characters need not be enclosed in dollar signs ($). 

In the second format, any characters may be used (including a period 
or right parenthesis), but special characters must be enclosed in 
dollar signs. 

This directive applies only if the procedure is executed in screen mode. 

.NOTE Directive 

The .NOTE directive specifies the message that appears on the screen and in your dayfile at 
the end of the procedure call (once all required parameters are supplied). Unless specified 
to do otherwise, the system clears the screen at the end of the call (refer to the .NOCLR 
Directive), and the screen is blank until the procedure completes execution or sends output 
to the terminal. 

Format; 

.NOTE,message. 

.NOTE^nsessage. 

Parameter Description 

message Specifies a 1- to 40-character text string that appears on the screen 

and in your dayfile. You can use uppercase and lowercase characters 
in the string. 

In the first format, any alphanumeric or special characters may be 
used except a period or right parenthesis (. or )). Special 
characters need not be enclosed in dollar signs ($). 

In the second format, any characters may be used (including a period 
or right parenthesis), but special characters must be enclosed in 
dollar signs. 

This directive applies only if the procedure is executed in screen mode. 


60459680 K 


4-31 



■PAGE Directive 


The .PAGE directive specifies the string that precedes the page number for procedure 
displays that require more than one screen. 

Po rmat: 

.PAGE,text. 

.PAGE=text. 

Parameter 


text 


.PROMPT Directive 

When a procedure is called in screen mode, the .PROMPT directive defines the last line of 
the screen, assuming no .HELP text is being shown. By default, this line tells the 
procedure caller how to proceed. For menu procedures, the input field immediately follows 
this prompt. In line mode, this directive applies only to menu procedures, where the system 
produces a screen-like display. 

Format: 

.PROMPT,text. 

.PROMPT-text. 

Parameter Description 

text Specifies a 0- to 40-character text string that appears as the prompt 

on the screen. The text string can be a maximum of 40 lowercase 
(12-bit) characters, 80 uppercase (6-bit) characters, or any 
combination of lowercase and uppercase characters that does not exceed 
480 bits. 

In the first format, any alphanumeric or special characters may be 
used except a period or right parenthesis (. or )). Special 
characters need not be enclosed in dollar signs ($). 

In the second format, any characters may be used (Including a period 
or right parenthesis), but special characters must be enclosed in 
dollar signs. 


Description 


Specifies a 0- to 40-character text string. You can use uppercase and 
lowercase characters in the string. The default is; 

Page 

In the first format, any alphanumeric or special characters may be 
used except a period or right parenthesis (. or )). Special 
characters need not be enclosed in dollar signs ($). 

In the second format, any characters may be used (including a period 
or right parenthesis), but special characters must be enclosed in 
dollar signs. 
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Parameter 


Description 


If the text parameter is omitted, the system issues the following 
prompts: 


Mode and 

Procedure Format Prompt 

Screen mode 

Interactive 

procedure Specify values and press NEXT when ready. 

Menu procedure Select from the list above and press NEXT. 
Line mode 


Interactive 

procedure (Not applicable) 

Menu procedure SELECT BY NUMBER OR TYPE Q TO QUIT. 


EXPANSION CONTROL DIRECTIVES 

The expansion control directives allow you to control certain aspects of procedure 
expansion. These directives allow you to inhibit expansion of portions of a procedure, to 
change the inhibit and concatenation characters, and to skip portions of the procedure when 
writing lines to the procedure command record. 


•CC Directive 

The .CC directive specifies the character used to concatenate character strings during 
procedure expansion. The new concatenation character remains in effect until the procedure 
terminates or until you enter another .CC directive. The default concatenation character is 
the ASCII character _ or the CDC graphics characterr~^. The .CC directive can be placed 
anywhere in the procedure. 

Format; 

.CC(n) 

Parameter Description 


n Specifies the new concatenation character. 


.EXPAND Directive 

The .EXPAND directive terminates, restores, or alters procedure expansion for subsequent 
lines of the procedure. The .EXPAND directive can be used anywhere in the procedure 
following the formatting and help directives. 

Format: 

EXPAND,option 
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Parameter 


Description 


ON Specifies that subsequent lines of the procedure are expanded 

normally. This is the default value. 

OFF Specifies that no parameter substitutions or directive processing is 

performed on subsequent lines. In other words, any subsequent 
commands or procedure directives are written to the command record 
just as they appear in the procedure file. 

EXPLICIT Specifies that subsequent procedure lines are expanded; however, only 
keywords preceded by the concatenation character undergo parameter 
substitution. 

IMPLICIT Specifies that subsequent procedure lines are expanded and all 
keywords undergo substitution. 

•IC Directive 

The .IC directive specifies the character used to inhibit parameter substitution or 
directive processing during procedure expansion. The new inhibit character remains in 
effect until the procedure terminates or until you enter another .IC directive. The default 
inhibit character is the ASCII character // or the CDC graphics character =. The .IC 
directive can be placed anywhere in the procedure. 

Format; 

.IC(n) 

Parameter Description 

n Specifies the new inhibit character. 


.SET Directive 

The .SET directive allows you to build new parameters using strings and substrings created 
by the STR, STRB, and STRD functions and concatenation operations, which are described in 
section 6. 

Format: 

.SET,keywd]^=strexpi,... ,keywdji=strexpjj. 

Parameter Description 

keywdji^ Defines a new keyword or references an existing keyword, either from 

the .PROC header or from an earlier .SET directive, keywdj^ can be 
substituted in subsequent statements as if it were a formal parameter 
in the .PROC header. 

If keywdj^ is an existing keyword, it is prefixed with an inhibit 
character to avoid unwanted substitution of the existing value. 

If keywdj^ is enclosed in dollar signs, values substituted for 
keywd^ in subsequent statements remain in or are converted to the 
literal format (by appending prefixing and suffixing dollar signs and 
replicating any dollar signs that occur within the values). 

strexp^ May be any valid CCL expression, usually but not necessarily an 

expression that produces a string result. If the result of strexpi 
is not a string but a value, the value is left-justified and 
considered a string. The resulting string in either case is 
substituted for any occurrences of keywd^ in subsequent statements 
of the procedure. 
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Example 1: 


.PR0C,CATTER*I,P1=(*A),P2=(*S3/D>. 

.SET,K9=STR($P1$,1,4)//STRD(P2,-1). 

.IF,$K9$.EQ.$G00D1$,G0. 

NOTE./THE 1ST 4 CHAR OF PI AND THE LAST OF P2 = K9. 

.ELSE,GO. 

REVERT,EX.DISPLAY,STR($SORRY, K9 IS NOT GOODIS). 

.ENDIF,GO. 

In this example, two substrings were concatenated to produce one string in the .SET 
expression. Every occurrence of keyword K9 in the lines following the .SET directive is 
replaced by the string resulting from the concatenation of substrings PI and P2. If GOODY 
and 101 were supplied as values for PI and P2, the value of K9 would be set to GOODl. (For 
a detailed explanation of how the STR and STRD functions operate, refer to section 6.) The 
subsequent .IF statement would be true, causing the NOTE command to be Included and 
executed. If BADNEWS were substituted for PI, the .IF statement would be false, resulting 
in the execution of the REVERT command and then the DISPLAY command. 

Example 2: 

.PR0C,VALUES*I,P1=(*S/0),P2=(*S/D). 

.SET,V1=STRD <P1+P2),V2=STRD <P1 *P2),V3=STRD(PI**P2). 

.IF,V1=V2=V3.NOTE./SUH, PRODUCT AND POWER ARE EQUAL. 

NOTE./THE SUM OF PI AND P2 IS VI. 

NOTE./THE PRODUCT OF PI AND P2 IS V2. 

NOTE./PI TO THE POWER OF P2 IS V3. 

As this example demonstrates, the .SET directive along with the STRD function can create new 
keywords that make it possible to include arithmetic values as strings in subsequent 
commands and directives. 

Example 3: 

.PR0C,LITKW*I,P1=(*A),$P2$=(*A). 

NOTE./ #P1(P1) #P2(P2) #P3(P3) #P4(P4) 

.SET,P3=$GHI$,$P4$=$JKL$. 

NOTE./ #P1(P1) #P2(P2) #P3(P3) #P4(P4) 

.SET,$#P1$=$P1$,#P2=P2,$#P3$=$P3$,#P4=P4. 

NOTE./ #P1(P1) #P2(P2) #P3(P3) #P4(P4) 

REVERT. LITKW COMPLETED. 

Execution of procedure LITKW using a BEGIN command produces; 

07.16.51.BEGIN,,LITKW,ABC,OEF. 

07.16.52.NOTE./ PI(ABC) P2($DEF$) P3(P3) P4(P4) 

07.16.52.NOTE./ PI(ABC) P2($DEF$) P3(GHI) P4($JKL$) 

07.16.52.NOTE./ Pi($ABC$) P2(DEF) P3($GHI$) P4(JKL) 

07.16.52.REVERT. LITKW COMPLETED. 

This example illustrates the creation of keywords not previously defined, redefinition of 
existing keywords, and changing the literal keyword characteristics of existing keywords. 


FILE DIRECTIVES 

The file directives either create local files during procedure expansion time or place file 
marks in the procedure command record. 
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•DATA Directive 


A .DATA directive in a procedure marks the beginning of a sequence of data lines to be 
written to a separate file when the procedure is called. The data file can contain program 
source code, other NOS procedures, or any other type of data. 

Format: 

.DATA,lfn. 

Parameter Description 

Ifn Specifies the name of the file on which the data lines are to be 

written. If a file named Ifn is already assigned to the job, it is 
returned, and new local file Ifn is created. You cannot specify INPUT 
for Ifn. If Ifn Is not specified, the .DATA file can be referenced in 
the procedure header using the special symbol #DATA. 

The default for Ifn depends on the nesting level of the procedure. At 
the first procedure level, the system calls this file ZZCCLAA; at the 
second procedure level, it is ZZCCLAB; and so on. 

You can use the .IF, .ELSE, and .ENDIF directives within the data lines following the .DATA 
directive to conditionally include lines in the data file. 

File marks generated by .EOF and .EOF directives can subdivide the lines written to the data 
file into records or files. The sequence of data lines is terminated by one of the 
following; 

e Another .DATA directive. 

e An end-of-record (not an .EOF directive) in the procedure file. 

e An end-of-file (not an .EOF directive) in the procedure file. 

e An end-of-information in the procedure file. 

The data file created does not Include the .DATA directive. Keyword substitution continues 
within the data file unless you Insert a .EXPAND directive to suspend expansion processing. 
After the data file is written, it is rewound. 
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The following examples show three different ways of inserting a FORTRAN 5 program into a 
procedure. 

Example 1: Procedure accesses program data with .DATA directive 

The following procedure is on an indirect access pennanent file named DATAFIL. 

.PROC,ALPHA*I, 

P1 = (*F,*N=#DATA)^ 

LSTFILE=(*F,*N=FTNOUT). 

FTN5,I=P1,L=LSTFILE. 

L60. 

REPLACE,LSTFILE. 

.DATA 

PROGRAM APROG 


statements 


END 


The following BEGIN command in a command record of the job accesses procedure ALPHA on file 
DATAFIL. 


BEGIN,ALPHA,DATAFIL. 


A sample of a resulting dayfile is: 


11.07.59.BEGIN,ALPHA,DATAFIL. 

11.07.59.FTN5,I=ZZCCLAA,L=FTN0UT. 

11.08.00. 61000 CM STORAGE USED. 

11.08.00. 0.015 CP SECONDS COMPIUTION TIME. 

11.08.00.LG0. 

11.08.00. STOP 

11.08.00. 5600 FINAL EXECUTION FL. 

11.08.00. 0.000 CP SECONDS EXECUTION TIME. 

11.08.00.REPLACE,FTN0UT. 

11.08.01.$REVERT.CCL 


All input after the .DATA directive (the FORTRAN 5 source program) is written onto the 
default temporary file ZZCCLAA. Parameter substitution is performed on the FORTRAN program 
prior to its being written to ZZCCLAA. 
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Example 2: Procedure accesses program data with //FILE 


The following procedure is on an indirect access permanent file named PFILE. The record 
immediately following procedure BETA contains the program data. The //FILE default tells the 
FTN5 compiler to search for input from the next record on file PFILE. 


.PROC,BETA*I, 
P1=(*F,*N=#FILE), 
LSTFILE=(*F,*N=FTNOUT). 
FTN5,i=P1,L=LSTFILE, 
L60. 

REPLACE,LSTFILE. 

-EOR- 

PROGRAM BPROG 


statements 


END 

The following call accesses procedure BETA on file PFILE. 


BEGIN,BETA,PFILE. 


The following is a segment of the resulting dayfile. Parameter substitution occurred within 
the procedure but not within the FORTRAN 5 program. 

11.08.35.BEGIN,BETA,PFILE. 

11.08.36.FTN5,1=PFILE,L*FTN0UT. 

11.08.36 . 61000 CM STORAGE USED. 

11.08.36. 0.013 CP SECONDS COMPILATION TIME. 

11.08.36.LG0. 

11.08.37. STOP 

11.08.37. 5600 FINAL EXECUTION FL. 

11.08.37. 0.000 CP SECONDS EXECUTION TIME. 

11.08.37.REPLACE,FTNOUT 
11.08.37.$REVERT.CCL 
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Example 3: Procedure accesses program data from another file 

A procedure may access data outside of the procedtnre file. The following procedure is in 
the default file FROCFXL. It uses a GET command to access the program data on file TEST and 
writes the binary output. 

.PR0C,GAI'MA*I,P1=(*F),X=C*N=FTN0Ur) . 

GET,PI. 

FTN5,I=P1,L=X. 

LGO. 

REPLACE,X=LISTF1L. 


The following call accesses procedure file GAMMA. 
BE GIN,G/WMA,,P1=TEST. 


Parameter substitution occurs within the procedure but not within the FORTRAN 5 program, as 
shown in the following dayfile segment. 

11.06.48.BEGIN,GAMMA,,PI =TEST. 

11.06.48.GET,TEST. 

11.06.49.FTN5,I=TEST,L=FTN0UT. 

11.06.50. 61000 CM STORAGE USED. 

11.06.50. 0.013 CP SECONDS COMPILATION TIME. 

11.06.50.LGO. 

11.06.51. STOP 

11.06.51. 5600 FINAL EXECUTION FL. 

11.06.51. 0.000 CP SECONDS EXECLTFION TIME. 

11.06.51.REPLACE,FTN0UT=LISTFIL. 

11.06.51.SREVERT.CCL 
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.EOF (or .EOP) Directive 


The .EOF (or.EOP) directive generates an end-of-file on the data file created with a .DATA 
directive. Wherever an .EOF appears> an actual end-of-file is recorded when the data file 
is written on the file specified in the .DATA directive. The system always writes an 
end-of-record at the end of a data file. If you want an end-of-file also, you must end the 
file with an .EOF directive. The .EOF directive is valid only after a .DATA directive. The 
.EOP directive may be used interchangeably with the .EOF directive. 

Format: 

.EOF. 

.EOP. 


•EOR (or .EOS) Directive 

The .EOR (or .EOS) directive is used to separate records in a data file created with a .DATA 
directive. Wherever an .EOR is placed, an actual end-of-record is recorded when the data 
file is written on the file specified in the .DATA directive. The system always writes at 
least one end-of-record at the end of a data file, whether or not you specify an .EOR 
directive. The .EOR directive is valid only after a .DATA directive. The .EOS directive 
may be used interchangeably with the .EOR directive. 

Format: 

.EOR. 

.EOS. 


BRANCHING DIRECTIVES 

The branching directives provide conditional inclusion of commands, other directives, or 
data lines in the procedure. The function of the .ELSE, .ENDIF, and .IF directives is much 
like that of their command equivalents. The branching can appear in any of the four 
sections of the procedure body. 

.ELSE Directive 

The .ELSE directive in conjunction with a preceding .IF (or .ELSEIF) directive either 
terminates or initiates the skipping of lines in the procedure body. 

Format; 

.ELSE,label. 

Parameter Description 


label Specifies a 0- to 10-character alphanumeric string. The string must 

begin with an alphabetic character unless it is a null string. 

If the condition in the most recent matching .IF or .ELSEIF directive was true, the .ELSE 
directive initiates the skipping of the lines between itself and the next matching .ENDIF 
directive (two directives match only if their label parameters are identical). If the 
condition in the most recent matching .IF or .ELSEIF directive was false, the .ELSE 
directive terminates the skipping that the .IF or .ELSEIF directive initiated. An .ELSE 
directive cannot terminate the skipping initiated by another .ELSE directive. 
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.ELSEIF Directive 


The .ELSEIF directive in conjunction with a preceding .IF (or .ELSEIF) directive either 
terminates or inititiates the skipping of lines in the procedure body. 

Format: 

.ELSEIF,expression,1abe1 

Description 


Specifies an expression that is either true or false (refer to Command 
Syntax in section 6). 

Specifies a 1- to 10-character alphanumeric string that must begin 
with an alphabetic character. An identical label must appear on a 
subsequent .ELSE, .ELSEIF, and/or .ENDIF directive. 

If the most recent matching .IF or .ELSEIF condition is true, the .ELSEIF directive 
functions as an .ELSE statement; that is, the statements between the .ELSEIF and the next 
matching .ENDIF directive are skipped. (Matching statements have identical labels.) 

If the most recent .IF or .ELSEIF condition is false, the system stops skipping lines and 
evaluates the .ELSEIF condition: 

• When the .ELSEIF condition is true, no more lines are skipped and the system 
processes the statements between the .ELSEIF directive and the next matching .ELSE. 
.ELSEIF, or .ENDIF. 

• When the .ELSEIF condition is false, the system skips the lines between the .ELSEIF 
statement and the next matching .ELSE, .ELSEIF, or .ENDIF directive. 


Parameter 

expression 

label 
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.ENDIF Directive 

The .EroiF directive terminates skipping initiated by a matching .IF, .ELSE, or .ELSEIF 
directive (directives match only if their label parameters are identical). 

Format: 


.ENDIF,label. 
Parameter 


label 


Description 

Specifies a 0- to 10-character alphanumeric string. The string must 
begin with an alphabetic character unless it is a null string. 


.EX Directive 

The .EX directive submits a single command to the system for immediate execution. The 
system performs keyword substitutions in the command before executing the command. No 
further procedure directives are normally processed. Although .DATA files are created, the 
command record is never executed. Since the command record is not executed, the procedure 
nesting level of your job is not incremented. 

Format; 

.EX.command. 

Parameter Description 

command Any valid command. The length of the expanded command cannot exceed 

80 characters. 

If the command entered by .EX aborts, the system responds as though the command had been 
entered from the calling job or procedure. For example, assume that procedure A calls 
procedure B and that procedure B contains a .EX directive. If the command entered by the 
.EX directive is erroneous, the system immediately suspends command processing and begins 
searching for an EXIT command in procedure A* 

The .EX directive is most often used in menu procedures in which the command executed by .EX 
is a call (BEGIN command) to another procedure. Since the purpose of the menu procedure is 
merely to prompt for a single item of user input, the most efficient way of calling the 
resulting procedure is in a .EX directive. 

Example: 

The following menu procedure initiates one of three nested procedures, (EXECl, EXEC2, or 
EXEC3) depending on the menu item selected. 

.PR0C,FIX*M,P= 

(1"OPTION 1", 

2"OPTION 2", 

3"0PTI0N 3"). 

.EX.BE6IN,EXEC_P,PFILE. 

REVERT^NOLIST. 
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.IF (or .IFE) Directive 


The .IF directive conditionally writes lines from the procedure body to the procedure 
command record or the file associated with the .DATA directive. The .IF directive is to the 
procedure command record as the IF command is to the job command record (refer to the IF 
command). Before evaluating the conditional expression, the system performs parameter 
substitution for the portion of the directive that follows the .IF. Since the system 
processes the .IF directive at procedure expansion time, the .IF directive cannot depend 
upon the effects of commands in Che procedure body. 

Formats: 


.IF,expression.command. 
.IF,expression,label. 


Parameter Description 

expression Specifies an expression that is either true or false (refer to Command 
Syntax in section 6). The separator following expression in the first 
format must be a terminator. 


command Specifies any valid system command. 

label Specifies a 0- to 10-character alphanumeric string. The string must 

begin with an alphabetic character unless it is a null string. An 
identical string must appear in a subsequent .ELSE, .ELSEIF or .ENDIF 
directive. 


If expression is true, the first format writes command in the procedure command record while 
the second format processes all lines between the .IF directive and the first matching 
.ELSE, .ELSEIF or .ENDIF directive (two directives match only if their label parameters are 
identical). 


If expression is false, the system does not write command in the procedure command record 
(for the first format) nor does the system write and process the lines between the .IF 
directive and the first matching .ELSE, .ELSEIF or .ENDIF directive (for the second format). 


I NOTE 


When using the first format (.IF,expression, 
command.), values for .command, that match a 
relational, logical, or string operator 
(such as .EQ. or .OR.) are interpreted as 
operators, causing the procedure to abort. 

To write a valid .IF directive when .command, 
matches an operator, terminate the expression 
or command with a right parenthesis instead 
of a period. 


Iterative Directives 

The directives .WHILE and .ENDW enclose a group of lines into a loop to be processed 
repeatedly. The .WHILE statement starts the loop; the .ENDW statement ends the loop. The 
.WHILE and .ENDW labels must match. The loop is repeated as long as the .WHILE condition is 
true. When the .WHILE condition is false, control is passed to the matching .ENDW statement. 
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.ENDW Directive 


Format: 


.ENDW,label. 

Parameter Description 

label Specifies a 1- to 10-character alphanumeric string that must begin with 

a alphabetic character. The label must match a label on a previous 
.WHILE directive. 

When the matching .WHILE condition is true, the .ENDW statement causes processing to jump 
back to the .WHILE statement, and the statements in the loop are executed again. When the 
matching .WHILE condition is false, processing continues with the statement following the 
.ENDW directive. 


.WHILE Directive 

Format: 


.WHILE,expression,label. 

Description 

Specifies an expression that is either true or false (refer to Command 
Sysntax in section 6.) 

Specifies a 1- to 10-character alphanumeric string that must begin with 
an alphabetic character. An identical label must appear on a 
subsequent .ENDW directive. Each .WHIU label should be unique. 
Duplication of labels causes unpredictable results. 

If the .WHILE condition is true, the lines between the .WHILE and the matching .ENDW are 
repeated. When the .WHILE condition is false, processing continues at the line following 
the .ENDW directive. 

Example: 


Parameter 

expression 

label 


The following set of directives search parameter A for the slash character and then split 
the data into two parameters. The data to the left of the slash is put in parameter B; the 
data to the right of the slash is put into parameter C. If no slash is found, B contains 
null and C contains all the data in A. 

.SET,COUNT=STRD(len($AS)). 

.WHILE,(COUNT.GT.O) .AND. <STR($AS,C0UNT,C0UNT) .NE. STR($/$))- LOOP. 

SET,#C0UNT=STRD(C0UNT-1). 

.ENDW,LOOP. 

.SET,B=STR($AS$,1,COUNT-1). 

SET,C=STR($AS$,COUNT+1). 
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COMMENT (.*) Directive 


The .* directive enables you to document a procedure with internal comments. These comments 
do not appear in the dayfile when the procedure is processed. The comment, which follows 
the can contain any combination of characters. 

Format: 

.*comment 

Parameter Description 

comment Represents your comments. 

The comment directive can appear anywhere in the procedure body. However, a comment 
directive inserted in the help section is considered as part of the help text. 
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CALUNG A PROCEDURE (BEGIN COMMAND) 

The BEGIN connnand initiates execution of a procedure. When a BEGIN command is entered, the 
system begins executing the specified procedure and continues until a REVERT command is 
entered. The REVERT command causes the system to return to the command record of the calling 
procedur^ The system then continues execution with the first command following the 
BEGIN command. Procedures can be nested up to a level of 50 nested procedures. 

j^gure 4-5 shows a diagram of a procedure call from a batch job and frcmi an interactive job. 
The interactive example also diagrams a first level nested procedure call. 
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You can alter the contents of a procedure by passing parameters to the procedure through the 
BEGIN command. The system substitutes the parameter values Into the procedure body according 
to the rules specified In the procedure header (refer to .PROC Directive earlier in this 
section). 

The system allows you to input the parameters from a full-screen format if the following 
conditions are true: 

• Your terminal supports full-screen input for procedures. 

• Your terminal is in screen mode (refer to the SCREEN command). 

• The procedure is interactive; that is, the .PROC directive contains a *M or *1. 

• You do not supply all the required parameters on the procedure call. 

Formats: 

BEGIN,pname,pfile,P2^,P2, • • • ,Pn*conunent 
or 

-pname,pfile,pj^,P2,...,pn.comment 
or 

pname,pj,p 2 ,...,pa.comment 
or 


pfile,pi,p 2 ,...,pn.comment 


The first format is the full BEGIN command format that can be used in either batch or 
interactive jobs. When you use this format, the system uses the following search order when 
attempting to locate file pflle: 

• local files 

• indirect access files in your permanent file catalog 

• direct access files in your permanent file catalog 

• indirect access files under user name LIBRARY 

• direct access files under user name LIBRARY 

The second format can be used only from an interactive job. It uses the same search order 
as the first format. 

The third and fourth formats are the name call formats in which the command name BEGIN can 
be omitted. 
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The third format can be used from a batch or interactive job if one of the following is true: 

• pname is a procedure within a record in a file called pname. The system locates 

this procedure record and executes it. 

• pname is a procedure in a global library set. 

• pname is a procedure in the system library. 


The fourth format can be used from a batch or interactive job. pfile is the napio of a local 
file. The system executes the first procedure on pfile. 

Parameter Description 

pname Specifies the procedure name from the procedure header directive. If pname 

is omitted from the first format, two consecutive commas must be specified. 
The default procedure is the record at the current position of pfile. If 
pfile is at its end-of-information, the system rewinds pfile and uses the 
first procedure on pfile. If pfile is INPUT, the file is not rewound. 

pfile Specifies the name of the file containing the procedure. The file name 

pfile must be Inserted as the second parameter in the first format. Its 
omission is indicated by two consecutive commas following pname. To get a 
description of the procedure pname, you can append a question mark to pfile 
(refer to Requesting Help on Procedure Calls later in this section). File 
fs not automatically returned after the procedure executes. 

If pfile is omitted from the first format, the installation-defined default 
file name is used (PROCFIL is the default). 


Pi Specifies an optional parameter that may affect the substitution to be made 

for a keyword used in the procedure. The value you specify is compared to 
the appropriate checklist specified for this parameter in the procedure 
header. The checklist entries are checked in a left-to-right fashion and 
the first match determines the substitution. Refer to the .PROC Directive 
in this section for more details on parameter substitution. The specific 
formats for pj^ are described later in this subsection. 

If you are using the third or fourth format of the BEGIN command as 
previously shown, there is a 7-character restriction on both the keyword 
portion and the value portion of the parameter p^. 

comment Specifies the value associated with the comment keyword (ck) on the 
procedure header. The value consists of any characters you specify 
following the terminator. If the ck keyword appears on the procedure 
header, the system substitutes your comment for the comment keyword ck in 
the procedure body. Otherwise, the system ignores this comment. 
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For interactive procedures (*I), optional parameters p^^ can have the following formats: 


IL 

keywrd 

keywrd? 

or 

7 

keywrd= 

keywrd= 


Description 


Specifies a parameter identical to a keyword on the procedure header. 
Substitution is controlled by the *K entry in the checklist for the 
parameter. 

Specifies interactive BEGIN processing (refer to Requesting Help on 
Procedure Calls later in this section). 


Removes keywrd in the procedure body (null substitution) unless overridden 
by a checklist specification. 

val Allows order-independent substitution (refer to Parameter Matching Modes in 
this section). val replaces keywrd in the procedure body unless the 
associated checklist specifies otherwise, val can be a 1- to 40-character 
symbolic name or value. Section 6 describes symbolic names, val can 
contain special characters (nonalphanumeric) if they are delimited by dollar 
signs. Asterisks are the exception; they can appear without dollar sign 
delimiters. 


This parameter format has the following valid variations: 

Format Meaning 

keywrd=val Substitutes the string val for keywrd. 
keywrd=val+ Substitutes the decimal value of val for keywrd. 
keywrd“val+D Same as ke 3 rwrd=val+. 

keywrd=val+B Substitutes the octal value of val for keywrd. 


When calling a procedure, a keyword can be named more than once if the 
keywrd=val parameter format is used each time. The system issues a message 
informing you that a keyword is named more than once on the command. It 
uses the value specified with the last occurrence of the keyword. 
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-Ei. Description 

val unless overridden by a checklist specification, assigns this 0- to 

DOsitioriri-h’'^^®’'‘'^r °“^y>/y'“bolic name or value to the keyword whose 
position in the procedure header parameter list matches the position of this 

command parameter list (refer to Parameter Matching 

aJ^risL Special characters (nonalphanumeric), other than 

delimited by dollar signs. This parameter format has 
the following variations: uas 


Format 



val 

Substitutes 

the 

val+ 

Substitutes 

the 

val+D 

Substitutes 

the 

val+B 

Substitutes 

the 


Meaning 

string val itself, 
decimal value associated with val. 
decimal value associated with val. 
octal value associated with val. 


"note I 

If you specify a parameter p^ on a name 

^ local file, neither the keyword 
keywrd or the value val can exceed seven 
characters. 


For menu procedures (*M), the procedure call can contain only 
p^. On such calls, p^ can have one of the following formats: 


one substitution 


parameter 


choice 


choice? 

or 

7 


Description 


Specifies a menu selection that appears on the procedure header, 
selection must be an unsigned integer. 


The menu 


Specifies interactive help processing 
Calls later in this section). 


(refer to Requesting Help on Procedure 


If you omit p^, the system displays the menu and prompts for a menu selection 
Example: 


The following procedure is accessed by a sequence of BEGIN commands 
the job. 


in the command 


record of 


.PR0C,TEST1*I,FK. 
COMMENT. FK 
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The resulting dayfile shows each BEGIN command and the substitutions made. The relevant 
segment of the dayfile is as follows: 


10.15.26. BEGIN,TEST1,FKTEST,20. 

10.15.27. COMMENT. 20 

10.15.27. REVERT.CCL 
10.15.27.SET,R2=100. 

10.15.27. BEGIN,TEST1,FKTEST,FK=R2+. 

10.15.28. COMMENT. 100 

10.15.28. REVERT.CCL 

10.15.28. BEGIN,TEST1,FKTEST,FK=R2-K>. 

10.15.29. COWIENT. 100 

10.15.29. REVERT.CCL 

10.15.29. BEGIN,TEST1,FKTEST,FK=R2+B. 

10.15.30. COMMENT. U4 

10.15.30. REVERT.CCL 

10.15.30. BEGIN,TEST1,FKTEST,FK. 

10.15.31. C0WIENT. FK 

10.15.31. REVERT.CCL 

10.15.31. BEGIN,TEST1,FKTEST,FK=. 

10.15.32. COMMENT. 

10.15.32. REVERT.CCL 

10.15.32. BEGIN,TESTI^FKTEST,VALUE. 

10.15.33. C0MMENT. VALUE 

10.15.33. REVERT.CCL 

10.15.34. BEGlN,TEST1,FKTEST,$VALUE-2$. 

10.15.34. COMMENT. VALUE-2 

10.15.34. REVERT.CCL 

10.15.35. BEGIN,TEST1,FKTEST,*. 

10.15.35. C0MMENT. * 

10.15.35. REVERT.CCL 


REQUESTING HELP ON PROCEDURE CALLS 

After you call a procedure interactively but before the system executes the specified 
procedure, you can have a dialogue with the system about the procedure. This is possible 
only if the procedure writer appended the *I or *M to the procedure name in the procedure 
header (refer to the .PROG directive described in this section). You can do any of the 
following: 

• Request help information about the procedure itself. 

• Request help information about a procedure parameter. 

• Supply omitted parameters. 

• Reenter parameter values that are in error. 

If the parameter specifications in the procedure call are incorrect or incomplete, the 
system initiates the dialogue. You can also initiate the dialogue by requesting a 
description of the procedure or parameters in one of the following ways: 

• Append a question mark to the procedure file name. 

• Append a question mark to the name of a procedure parameter for *I procedures or to 
a menu selection for *M procedures. 
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• Enter a question mark as a parameter on the procedure call. 

• Enter a question mark in response to an interactive prompt. 

• Press the HELP key any time after you call the procedure if your terminal is in 
screen mode. 


If you omxt required parameters or if any parameter is in error on the procedure call the 

required parameters and those in error. If the system prompts 
Par^eter that need not be specified and you want to use the default for that 
parameter, enter a carriage return. If the format of a parameter entry is not correct or 

fir specified on the procedure header directive, you are reprompted 

for the parameter. Prompting for parameters terminates when: 


You satisfy all parameter requirements.. 

You enter a parameter followed by a terminator (a period or a right parenthesis), or 
enter just a terminator. If all required parameters have been entered, the system 
executes the procedure. Otherwise, the system continues prompting until all 
required parameters are satisfied. 


• It is a menu procedure executing in line mode and you enter Q. The system does not 
execute the menu. For nested menu procedures, entering Q causes the system to 
aiscontinue expansion of the current procedure and begin searching for an EXIT 
command in the calling procedure. 


Your terminal is in line mode and you enter the termination or interruption 
character for your terminal (refer to appendix J). The BEGIN command processing 
ends and the system does not execute the procedure. For nested procedures, 

termnating the dialogue in this way causes the system to search for an EXIT command 
in the calling procedure. 


Your terminal is in screen mode and you press the QUIT key. The system does not 
execute the procedure. For nested procedures, terminating the dialogue in this way 
causes the system to search for an EXIT command in the calling procedure. 


<^3“ always append a comment after the terminator on the call. 
Additionally, you can append a comment to a parameter entry made during a parameter- 

prompting dialogue. Still, the comment must follow a terminator (refer to the last example 
in this subsection). 
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The procedure calls in table 4-3 illustrate the various methods of requesting help on 
procedure calls. For convenience, we show the name call format of the BEGIN command. 


Table 4-3. Help on Procedure Calls 



Result 

Procedure Call 

Interactive 

Procedure (*I) 

Menu 

Procedure (*M) 

pname 

The system prompts for 
required parameters or 
parameter values in error. 

The system displays the 
menu and prompts for a 
selection. 

pname? 

The system provides any 
.HELP text about the pro¬ 
cedure itself and then 
prompts for parameters. 

The system provides any 
.HELP text about the proce¬ 
dure itself, displays the 
menu, and prompts for a 
selection. 

pname,? 

Same as pname? . 

Same as pname,? . 

pname,keywrd? 

The system provides any 
.HELP text for the 
parameter associated 
with keywrd and then 
prompts for parameters. 

Not applicable. 

pname,choice? 

Not applicable. 

The system provides any 
.HELP text for that menu 
selection, displays the 
menu, and prompts for a 
selection. 
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If your job is a batch Job and you request a description of the procedure or Its oaraueters 

SuLSJc;: ”*"' 1» f»e Job dayflle. If any of the r.qulrL ^raS" 

p cifications are in error, error messages appear in the dayflle. 
system does not execute the procedure. 


In either case, the 


The following example shows the interactive entry of parameters. 
Example: 

Procedure F5 resides on local file F5. 

. PR OC, F5 *1,1" IN PUT(* F,*N =IN PUT ) , 

B"BINARHS"= (*F,*N=La)), 
four PUT't (* F,*N=our put ), 

LO"LIST OPTIONS"=(*N=0, Q,0, R,S). 

FTN 5, #I =1, <© =B, =L, #1j0 =L0. 

REVERT. 

To elicit prompts for the parameters on the procedure, the user enters 


f5,? 

The following dialogue ensues: 

PARAMETERS FOR F5 ARE I, B, L, LO 
ENTER I INPUT? test 
ENTER B BINARIES ? bfiLe 
ENTER L OUTPUT ? listing 
ENTER LO LIST OPTIONS? s 
REVERT. 


S; SoSSi .'JSI'ln^nto'ceSai; 


.PR0C,F5*I,I'INPUT •= (*F,*N=INPUT 
B 'BINAR lES '= (* F,*N=LQ0) , 

L'0 UT PUT •* (* F, *N =0 UT PUT > , 

LD'LIST OPTIONS •=<*N=0,0,0,R,A,M,S). 
FTN5, « =I, #L =L, #Lo =L0. 

REVERT. 


To elicit prompts for the parameters on the procedure, the user enters 


f5,? 

The following dialogue ensues: 

PARAMETERS FOR F5 ARE I, B, L, LO 
INPUT? test 
BINARIES ? bfile 
OUTPUT ? listing 
LIST OPTIONS? s 
REVERT. 
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The following example shows help processing with a menu procedure 


NOTE 


The .HELP text uses lowercase and uppercase 
characters. 


/list,f=menu 

.PROC,HENU*M"SAMPLE MENU'',0PT10N= 

(1 "OPTION 1",2"0PTI0N 2", 3"0PTI0N 3") .COMMENT. 

.HELP 

This procedure shows the structure of a menu procedure. 
.HELP,1 

This is HELP text for option 1. 

.HELP, 2 

This is HELP text for option 2. 

.HELP,3 

This is HELP text for option 3. 

.ENDHELP. 

.1F,OPTION.EQ.1.NOTE.+YOU CHOSE ^OPTION 1 COMMENT. 
.IF,0PTI0N.EQ.2.N0TE.+Y0U CHOSE #0PTI0N 2 COMMENT. 
.IF,0PTI0N.EQ.3.N0TE.+Y0U CHOSE #0PTI0N 3 COMMENT. 
REVERT,NOLIST. 

/menu? 

This procedure shows the structure of a menu procedure. 
SAMPLE MENU 

1. OPTION 1 

2. OPTION 2 

3. OPTION 3 

SELECT BY NUMBER OR TYPE Q TO QUIT ? 1? 

This is HELP text for option 1. 

SAMPLE MENU 

1. OPTION 1 

2. OPTION 2 

3. OPTION 3 

SELECT BY NUMBER OR TYPE Q TO QUIT ? 2? 

This is HELP text for option 2. 

SAMPLE MENU 

1. OPTION 1 

2. OPTION 2 

3. OPTION 3 

SELECT BY NUMBER OR TYPE Q TO QUIT ? 3? 

This is HELP text for option 3. 
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SAMPLE MENU 

1. OPTION 1 

2. OPTION 2 

3. OPTION 3 

SELECT BY NUMBER OR TYPE Q TO QUIT ? 1. finally 
YOU CHOSE OPTION 1 FINALLY. 

/menu,2 

YOU CHOSE OPTION 2. 


ENDING A PROCEDURE (REVERT COMMAND) 

The REVERT cosnaand terminates procedure processing. 
Format; 


REVERT,option.command 


Parameter 


option 


command 


Description 


Controls the revert options and whether the REVERT command appears at 
the terminal and in the job dayfile. 


option Meaning 

ABORT Returns control to the next EXIT command in the command 

record unless a NOEXIT command has been processed. 

This parameter sets EF=CPE (CPU abort). It returns 
control to the command following the calling BEGIN 
command if a NOEXIT command has been processed. This 
parameter causes the REVERT command to appear at the 
terminal and in the job dayfile. 

EX Returns control to the command record of the calling 

procedure and executes the command parameter as if the 
command had actually appeared in the calling 
procedure. The EX parameter causes the REVERT command 
to appear In the job dayfile but not at the terminal. 


NOLIST Returns control to the command following the calling 

BEGIN command and suppresses the display of the REVERT 
command at the terminal and in the dayfile. 

If you omit option, control returns to the command following the 
calling BEGIN command. The REVERT command appears in the job dayfile 
but not at a terminal unless you are under the batch subsystem and the 
REVERT is not within a nested procedure call. 


Specifies a comment when used with the EX option. Otherwise, it 
specifies a comment. 


The system always appends the following commands to a procedure record. 

SREVERT.CCL 

SEXIT.CCL 

$REVERT,ABORT.CCL 

These commands terminate procedure processing if no user-supplied REVERT commands are 
processed. 
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Example: 


The following procedure (REVTST) is on a file called PROCFL. It reverts to the job calling 
it if the named file has no read permission and aborts (causing control to be transferred to 
the job EXIT command) if the named file has no read modify permission. 


.PR0C,REVTST*I,LFN1,LFN2. 

.1F,FILE(LFN1,RD),LABEL1. 

TDUHP,I=LFN1. 

.ELSE,LABEL1. 

revert.no read permission 

.ENDIF,LABEL1. 

.IF,FILE(LFN1,RM),LABEL2. 

C0PY,LFN2,LFN1. 

.ELSE,LABEL2. 

REVERT,ABORT. NO READ/MODIFY PERMISSION 
.ENDIF,LABEL2. 


The following two jobs (REVJOBl and REVJ0B2) call the REVTST procedure. REVJOBl attaches an 
execute-only file; REVJ0B2 attaches a read or execute file. 


REVJOBl. 

USER,USERNAM,PASSWRD,FAMNAME. 
ATTACH,FILE1/UN=ALTUSER,PW=PW1,M=E. 
BEGIN,REVTST,PR0CFL,FILE1,XFIL. 
COMMENT. RETURNS HERE 
EXIT. 

COMMENT. EXIT ON ERROR 


REVJ0B2. 

USER,USERNAM,PASSWRD,FAMNAME. 
ATTACH,FILE2/UN=ALTUSER,PW=PW2,H=R. 
BE6IN,REVTST,PR0CFL,FILE2,XFIL. 
COMMENT. RETURNS HERE 
EXIT. 

COMMENT. EXIT ON ERROR 


The following are the dayfile segments produced by REVJOBl and REVJ0B2. REVJOBl 
processes the REVERT command and terminates normally. REVJ0B2 processes the 
REVERT,ABORT command and terminates by error processing. 


17.03.53.REVJOBl. 

17.03.53.USER,USERNAM,,FAMNAME. 

17.03.53.CHARGE,*. 

17.03.53.* CHARGE<151A,5612PAY) 
17.03.56.ATTACH,FILE1/UN=ALTUSER,M=E. 
17.03.56.BEGIN,REVTST,PR0CFL,FILE1,XFIL. 
17.03.56.REVERT.no READ PERMISSION 
17.03.56.COMMENT. RETURNS HERE 
17.03.56.EXIT. 


17.05.05.REVJ0B2. 

17.05.05.USER,USERNAM„FAHNAME 
17.05.05.CHARGE,*. 

17.05.05.* CHARGE(1514,5612PAY) 

17.05.13.ATTACH,FILE2/UN=ALTUSER,M=R. 
17.05.13.BEGIN,REVTST,PR0CFL,FILE2,XFIL. 
17.05.13.TDUMP,I=FILE2. 

17.05.13. TDUMP COMPLETE. 

17.05.13.REVERT,ABORT. NO READ/MODIFY 
PERMISSION 
17.05.13.EXIT. 

17.05.13.COMMENT. EXIT ON ERROR 
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PARAMETER MATCHING MODES 


When you call a procedure, the system must match each parameter on the BEGIN command with a 
parameter on the procedure header. The system uses two methods of parameter matching, 
order-dependent and order-independent. 


ORDER-DB>BMDENT MODE 

In order-dependent mode, the system compares in order each parameter on the procedure call 
parameter in that position on the procedure header. If any parameter entries do 
not conform to the restrictions in the parameter checklist or required parameters are 
omitted on the procedure call, the system prompts you for them. After all required 
parameters are entered, the system substitutes the selected keywords into the procedure body 
according to the checklists in the .PROG directive. 

Example: 

Procedure ITEM is on a global library file: 

.PR0C,ITEM*1,F"LOCAL FILE N/WE*^ (*N=LG0,*F), 

L"NAHE OF LIST OUTPUT FILE"=C*N=OUrPUT,*F), 

BL"EACH FILE START ON NEW PAGE? YES OR NO’t (YES=$,BL$,NO=,*N=), 

NR''REWIND BEFORE & AFTER? YES OR N0"= (YES=,N0=$,NR$,*N=). 

ITEMIZE, F,#L=L_BL_NR. 

REVERT. 

The procedure is called: 

rrEH,LIST,,NO,NO. 

The parameters are matched in order-dependent mode and the procedure body becomes: 

ITEMIZE,LIST,L=OUr PUT,NR. 

REVERT. 

In order-dependent mode, the system treats excess parameters on the BEGIN command as a 
nonfatal error. 


ORDER-INDEPENDENT MODE 

For each BEGIN command, parameter matching always starts in order-dependent mode. The 
system switches to order-independent mode if, in the comparison of a BEGIN command parameter 
and a procedure header parameter, one of the following occurs. 

• A parameter on the procedure call is in the format keyword=value. 

• A reverse slant (\) precedes the parameter on the .PROG directive or the BEGIN 
command. 

• A slant (/) precedes the parameter on the .PROG directive. 

• A slant precedes the parameter on the procedure call and a slant separates any two 
parameters on the .PROG directive. 
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However, if a slant is specified on the procedure call and not on the .PROC directive, the 
slant is not treated as a separator, but as part of the parameter value. 

Parameter matching mode cannot switch back from order-independent to order-dependent mode. 

Once in order-independent mode, the system matches each successive keyword on the procedure 
call or Interactive entry to the identical keyword in the procedure header directive, 
regardless of the order of the procedure header parameters or the order of specification on 
the procedure call. 

To show order-independent parameter matching, the preceding example is slightly modified. 

An *K entry has been added to the BL parameter checklist to make BL a valid parameter 
entry. A reverse slant is used as a separator before the NR parameter to ensure 
order-independent mode. 

.PROC,rrEM1*I,F"LOCAL FILE NAME''=(*N=L60,*F), 

L"NAME OF LIST OUTPUT FILE"=(*N=OUTPUT,*F), 

\NR"REWIND BEFORE & AFTER? YES OR NO*'=(YES=,NO=$,NR$,*N=), 

BL"EACH FILE START ON NEW PAGE? YES OR NO"=(YES=$,BL$,NO=,*N=,*K=$,$BL). 
nEMIZE,F,#L=L_BL_NR. 

REVERT. 

The procedure call (ITEMl is on a global library file): 

ITEH1, LIST „BL,NR=N0. 

starts parameter matching in order-dependent mode. The reverse slant in the procedure 
header switches parameter matching to order-independent mode, BL and NR are matched in 
order-independent mode. In order-independent mode you must specify all parameters in the 
form keyword=value, unless there is an *K entry in the parameter checklist. Then you can 
specify just the keyword as the parameter entry. Since *K is specified in the BL parameter 
checklist, the system accepts BL as a parameter entry. The NR parameter must be specified 
as NR=value or omitted. 

After the substitution, the procedure body becomes 

ITE«IZE,LIST,L=OUTPUT,BL,NR. 

REVERT. 
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COAAMAND PROCESSING 


5 


Jobs entering the system consist of one or more logical records. The first logical record 
contains system directives (commands) which describe the processing that is to occur in the 
job file. In interactive jobs, you enter the commands directly at the terminal. This 
section describes command processing and how the commands affect other aspects of iob 
processing. 


The operating system recognizes four types of commands. 


• Local File Commands 


• Global Library File Commands 


These commands call programs or procedures on 
files that are assigned to the job. The namg of 
the command is simply the name of the file. LGO 
is an example. It is the system default local 
file used for retaining object code generated by 
one of the language processors. 

These commands call programs or procedures on 
files that have been specified in a LIBRARY 
command. 


• System Commands 


These commands are divided into 10 categories. 
Flow control commands 


Job control commands 
Special commands for interactive jobs 
File management commands 
Permanent file commands 


Load and dump central memory commands 
Tape management commands 
System utility commands 
Library utility commands 
Loader commandst' 

• Product Set Commands The product set commands call the various products 

available under NOS. Their formats are given in 
the applicable product reference manual and in the 
NOS 2 Applications Programmer's Instant. 

Since your executing programs can access the command record of your job, it is possible that 
they might manipulate items like user names and passwords. Hence, your executing programs 
can affect system security. 

I^Refer to the CYBER Loader Reference Manual. 
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COMMAND FORMAT 


All commands consist of from one to four fields• The first field Is optional. It Is a $ or 
/ prefix character which precedes the program name. If a $ Is present. It Indicates that 
the specified program to be executed must be loaded from the system library. Therefore, 
even If a local file of the same name Is present or a program or procedure of the same name 
resides on one of your global library files, the system program, not the local program or 
global library program. Is executed. In all interactive subsystems except the batch 
subsystem, the system places a $ in the first field of all commands. Even in the batch 
subsystem, the system places a $ in front of the file editing commands ALTER, DELETE, DUP, 
LIST, MOVE, READ, WRITE, and WRITEN. 

If you use a slant in the first field of local file or global library file commands, the 
system processes the parameters in operating system format. For global library file 
commands, the presence of an NPC= entry point in the specified library also forces the 
system to process the parameters In operating system format (refer to Voltime 4, Program 
Interface). Otherwise, the system processes local file and global library file commands in 
product set format. 

The slant option is ignored for command calls to programs residing on the system library. 

For those types of calls, parameters are processed in the operating system format unless the 
SC directive of SYSEDIT has been entered. Refer to the SYSEDIT command in the NOS 2 System 
Maintenance Reference Manual for a description of the SC directive. 

Example: 

If file EXTRACT is a local file and you enter 
/EXTRACT,A,B,10. 

the system treats the file as a local file command. The parameters are processed in 
operating system format because of the leading slant. 

The second field contains the name of the program to be executed. The command name can be 
any valid file name. 

The third field (optional) contains parameters which further define the operation to be 
performed. The parameter field is set off from the name field by a separator character. A 
valid terminator character must follow the third field (or the second field if no parameters 
are present). In interactive jobs, the terminator is optional. 

The fourth field consists of a comments field. The comments field follows the terminator. 

In general, the system ignores this field. However, some commands (MODIFY, FSE, GTR, 
LIBEDIT, and the like) read this comments field for directives. 

In general, commands may not be continued beyond a single line. Exceptions are the 
execution control commands (described in section 6) and tape management commands (described 
in section 12). 

Global library file commands containing an ARG“ entry point (ARG“ is described in Volume 4, 
Program Interface) are ,not required to follow either the operating system or product set 
format. The only syntax requirements enforced by the system for these commands is that the 
command name must be a valid file name followed by a separator. The command itself may have 
additional sjmtax requirements. 

The following is a comparison of the operating system and product set formats (refer to the 
NOS 2 Applications Programmer's Instant for commands using the product set format). 
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Operating System Format 


Product Set Format 


1. Valid separators are 

+ -"/=,( 

and any other character with a display 
code value greater than AAg except 
* ) $ . and blank. 

2. Valid terminators are 

. ) 

3. Letters, numbers, and the * are 
the only characters allowed in the 
parameter field. The one exception 
to this rule is the use of literals 
(that is, character strings delimited 
by dollar signs). Characters other 
than letters, numbers, and the * can 
be included in literals. No char¬ 
acters within a literal have special 
meanings. The content and 
processing of literals is the 
responsibility of the called 
program—the literals are not 
stored in the RA+2 parameter area 

as literals 

4. All embedded blanks within a command 
except those appearing in literals 
are ignored. 

5. Comments may appear on the command 
but they must follow the terminator. 

They may contain any character. 

Comments are not printed for some 
commands. 

6. Parameters, separators, and termi¬ 
nators are stored in the job's field 
length beginning at RA+2. The char¬ 
acters , . and ) are stored as binary 
zero. For all parameters and all valid 
separators except the comma, their dis¬ 
play code equivalent is stored. Refer 
to section 10 of Volume 4, Program 
Interface, for more information. If the 
command accepts literal parameters, the 
processing of the contents of the RA+2 
parameter area may be unpredictable. 
Parameters should instead be extracted 
from the command image at RA+70B. 


1. Same as for the operating system 
format. 


2. Same as for the operating system 
format. 


3. Same as for the operating system 
format. 


4. Same as for the operating system 
format. 


5. Same as for the operating system 
format. 


6. Parameters are stored in their dis¬ 
play code equivalent beginning at 
RA+2. Separators and terminators are 
stored as follows: 

Character Code (Octal) 


, 1 

= 2 

/ 3 

( 4 

+ 5 

6 
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Operating System Format Product Set Format 

Character Code (Octal) 

; 10 

) or • 17 

Other valid 16 

separators 

Refer to section 10 of Volume A, 
Program Interface, for more 
information. 

7. File names are one to seven alpha¬ 
numeric characters. In some products, 
file names beginning with a numeric 
character are invalid. 

8. Not NOS/be compatible. 8. NOS/BE compatible. 

In general, no parameter can contain more than seven characters. The exceptions include 
procedure calls, flow control commands, some tape management commands and system or global 
library file commands with an ARG= entry point. 

Depending on the program, the parameters can appear in either order-dependent or order- 
independent format. Order-dependent parameters are required when the parameters must be 
passed in a specific order. An example of order-dependent parameters is: 

RESEQ,MYFILE,B,,20. 

In this example, the system expects the resequencing increment to be passed as the fourth 
parameter; therefore, a separator must be present for the parameter not specified. 

Order-independent parameters may be passed in any order. This is made possible by the use 
of keywords. A keyword is an identifier which has meaning either by itself or when used in 
conjunction with an option. Usually, keywords are passed with an option and a separator. 

The separator must not be a comma. When the list of parameters is passed to the called 
program, all separators except commas are also passed. 

Some programs require specific separators (usually =), and others merely require that a 
separator be present. Examples of keyword notation are: 

1. C0B0L5,I=SFILE,B=BFILE. 

2. C0B0L5,B=BFILE,I=SFILE, 

3. COBOL5,L=0,E,EL. 

A. JOBX,T10,CMA5000. 

In examples 1 and 2, both parameters and separators are passed to the COBOL 5 compiler. 

Since these parameters are order independent, both commands produce the same result. 

In example 3, two keywords are passed with no separator character. In example A, the 
keyword is the first character of the first parameter and the first two characters of the 
second parameter. 


7. File names are one to seven alpha¬ 
numeric characters. 
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command being processed are written in the lob 
fea (refer to section 10 of volume 4). The job communication area is the 
wo^^ds of your job s field length, from RA through RA+778. Section 1 and 
appendix E in Volume 4, Program Interface, describe this area. 


The following commands produce the same image in the job communication area 
are processed using operating system format. 


Both commands 


PERMIT,FILEABC,US ERAAA=R,US ERBBB=W. 


$PERMIT,FILEABC,USERAAA=R,USERBBB=W. 


COAAMAND PROCESSING FLOW 

now)r*^*'” ^ command by the following steps (figure 5-1 shows the processing 

1. Reads the command from the job's command record or interactive terminal. 

2. Verifies the format of the command as described in Command Format. 

command is from an interactive terminal, the system compares the command with 
the list of special interactive command names. (See section 8 for a list of these 
commands.) If the command name is in this list, the command is processed by lAF. 


4. 


6 . 


7. 


9. 


Compares the specified command names with the list of command names. If the command 
name is CTIME. HTIME, RTIME, *. or STIME, the system processes the command. 

fdent^L'^o ^ assigned to the job with a name 

^ r Of the command. However, if a $ precedes the program name, 

® identical name is found, the program is loaded into 

BA 4 . ir*/ arguments are extracted from the command and stored in RA+2 through 

^+n+l (n is the number of parameters) unless the command is a system or global 
library file command with an ARG= entry point. The CPU is requested to begin 
execution unless special loader commands follow. 

Searches the global library directory for a program name that matches the command 
name. If a $ precedes the command name, this step is skipped. If the program is 
found, the system proceeds as in step 5; otherwise, the system searches further. 

Searches the central library directory (CPU library) for a program name that matches 
the coMand ^e. If the name is found, the system proceeds as in step 4; 
otherwise, the system searches further. 

If the c^and name is a three-character name with the first character alphabetic, 
and if there are no more than two parameters (each of which is an octal number), the 
system searches the peripheral processor library directory (PP library) for a 
propM n^e that matches the command name. If found, the name is placed as a 
peripheral processor request* 

If the system does not find the command name during any of the searches, it declares 
the command invalid and aborts the job. 


' NOTE I 

A command is normally echoed to the dayfile 
except for system commands or global library 
commands containing an SDM» entry point in 
the entry point list. 


60459680 K 


5-5 




Figure 5-1. NOS Command Processing Flow 
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EXIT PROCESSING 


When an error condition occurs during a job, the system searches the command record for an 
EXIT command.T If the record does not contain an EXIT command, the system terminates the 
job if the job is not interactive or returns control to the terminal if the job is 
interactive. If the system finds an EXIT command, it clears the error condition and 
processes the commands that follow the EXIT command. If the error was a time limit error, 
the limit is reset to the time used plus eight seconds. This gives you time for post~error 
cleanup operations. If the error was an SRU limit error, the limit is reset to the SRUs 
used plus eight SRUs. 

If a NOEXIT command has been processed, normal error processing is not performed. That is, 
if the no exit flag has been set by the NOEXIT command prior to the error, the error flag is 
cleared, no search is made for an EXIT command, and processing continues with the next 
command. An ONEXIT command can be used to return to error processing mode; it clears the no 
exit flag. 


The following sequence of commands illustrates this exit processing. 
JOBCCC. 

USER,SHCTH22,SMA1. 

NOEXrr. 

GET,A,B. 

ONEXrr. 

ATTACH,MASTER/M=W. 

SK1PEI,HASTER. 

COPYBF,A,MASTER. 

COPYBF,B,HASTER. 

PACK,MASTER. 

COPYSBF,MASTER. 

EXIT. 

ENQUIRE,F. 

-EOR- 

-EOI- 


This job attempts to make local copies of two indirect access permanent files and adds them 
to a direct access file. The NOEXIT command suspends error processing, and the job 
continues even if file A or B is not found. The ONEXIT command turns error processing back 
on. If any error occurs thereafter, processing skips to the EXIT command and continues with 
the ENQUIRE command. If no error occurs after the ONEXIT command, processing continues 
until reaching the EXIT command and then the job terminates (ENQUIRE command is not 
processed). 


tAfter a security conflict, the system does not always allow EXIT processing. Refer to 
Security Features in section 3. 
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FLOW CONTROL COMMANDS 


6 


Flow control commands control the processing sequence of commands within the command record 
of a job. They can insert commands from a procedure file, conditionally or unconditionally 
skip commands, and control error processing. To determine the conditions for transfer of 
control, you can use error flags, file attributes, or other job attributes. The flow 
control commands and a brief description of each appear in the following list: 


Command 

BEGIN 

DISPLAY 

ELSE 

ELSEIF 

END IF 

ENDW 

EXIT 

IF(or IFE) 

MODE 

NOEXIT 

ONEXIT 

REVERT 

SET 

SKIP 

WHILE 


Description 

Initiates processing of a procedure.t 

Evaluates an expression and displays the result in the dayfile of the 
job. 

Terminates skipping initiated by a false expression within an IF or 
ELSEIF command or initiates skipping to a matching ENDIF command. 

Terminates skipping initiated by a false expression within a matching IF 
or ELSEIF command and tests for conditional skipping of additional 
commands, or initiates skipping to a matching ENDIF command. 

Terminates skipping initiated by a matching IF, SKIP, or ELSE command. 

Establishes the end of the loop. 

Controls the command flow in the event of errors. 

Conditionally skips one or more commands. 

Specifies the type of errors the system recognizes for EXIT processing. 
Disables EXIT error processing. 

Enables EXIT error processing. 

Returns processing from a procedure to the command record of procedure 
that called it. 

Assigns values to special symbolic names. 

Skips to the first matching ENDIF command. 

Establishes the beginning of a loop. If the associated expression is 
true, the loop is processed; if it is false, the loop is not processed. 


t Section 4 contains a detailed description of this command. 
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COMMAND SYNTAX 


The syntax for these commands is similar to the syntax of all other commands as described in 
section 5. However, these are some significant differences. 

• Functions, arithmetic expressions, relational expressions, and logical expressions 
can appear in parameters of certain commands. 

• A right parenthesis ending an expression within a command cannot also serve as the 

command terminator. You must include an additional right parenthesis or period to 

terminate the command. 

• Parentheses can nest expressions within expressions. 

• A parameter can consist of more than seven characters. 

• A command can be longer than 80 characters if its parameter specifications require 

such. It can extend over more than one line if each line to be continued contains 
no more than 80 characters and ends with a separator. 

The following subsections describe the command syntax, including the operators, operands, 
and functions which make up valid expressions. Following that is a discussion of each 
command. 


OPERATORS 

Operators separate operands in a expression. There are four types of operators: 
arithmetic, relational, logical, and string. Operators are used in the expressions within 
the IF, WHILE, DISPLAY, and SET commands and the FILE, STR, STRB, and STRD functions. 


ARITHMETIC OPERATORS 


Integer arithmetic is used in each step of the evaluation of an expression. Division, 



decimal. Binary operands (specified using a postradix of B) are restriced to 9 digits not 
including the postradlx; results involving binary operands are restricted to 16 digits. 
Decimal operands and displayed decimal results are restricted to 10 digits (the system 
interprets each digit as a 6-bit quantity). For both binary and decimal operands, overflow 
is ignored .t 


tif an operand is one of the symbolic names Rl, R2, R3, or RIG, there are further 
restrictions. Refer to the SET command in this section. 
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The following are the arithmetic operators 


Operator 

+ 

* 

/ 

** 

Leading - 
Leading + 


Operation 

Addition. 

Subtraction. 

Multiplication. 

Division. 

Exponentiation. 

Negation. This operator may be used to obtain a one's complement. 
Ignored. 


RELATIONAL OPERATORS 

A relational operator produces a value of 1 if the relationship is true, and 0 if it is 
false. The following are the relational operators (either form may be used). 

Operator Operation 


= 

.EQ. 

Equal to. 


.NE. 

Not equal to. 

< 

.LT. 

Less than. 

> 

.GT. 

Greater than. 

£ 

.LE. 

Less than or equal to. 

> 

.GE. 

Greater than or equal to 
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LOGICAL OPERATORS 


When an expression contains a logical operator, the system evaluates all bits of each 
operand. Each bit of the first operand is compared to the corresponding bit of the second 
operand. If the comparison is true, the corresponding bit in the result is set to 1. If 
the comparison is false, the corresponding bit in the result is set to 0. The operator 
.NOT. is a special case, operating on a single operand. If the operand is nonzero, the 
corresponding bit is set to 0. If the operand is 0, the corresponding bit is set to 1. 

If neither of the operands in a logical operation is a string operand, the result of a 
logical operation is a 60-bit quantity. If one or both is a string operand, the result of 
the logical operation is a string whose length depends upon the result of the operation. 

The shorter of the two strings is logically extended with binary zero-fill to the length of 
the longer string for the logical operation, and trailing binary zero characters are 
truncated from the result string. 


Operator 

.EQV. 

.OR. 

.AND. 

.XOR. 

.NOT. 


Operation 

Equivalence (complement of the logical sum). 
Inclusive OR (logical sum). 

AND (logical product). 

Exclusive OR (logical difference). 

NOT. 


STRING OPERATORS 

String operators operate on string operands. A string operand is the result of one of the 
functions STR, STRB, STRD, or of a logical operation involving one or more string operands. 

Operator Operation 

// .CAT. Concatenation of two strings into one string. (Either // or .CAT. may 

be used.) 


Example: 


. PROC, CATTER*! ,PI = (* A) ,P2= (*S 3/D ). 

.IF,STR<$P1 $,1,4)//STRD(P2,-1).EQ.STR($GOOD1$),GO. 

NOTE./THE 1ST 4 CHAR OF PI ARE GOOD AND P2 ENDS IN 1 
.ELSE,GO. 

REVERT, EX. DISPLAY, STR (SSORRY, PI IS NOT GOODS). 

.ENDIF,G0. 

In this example, two substrings were concatenated to produce one string in the .IF 
expression. If GOODY and 101 were supplied as values for PI and P2, the .IF statement would 
be true, and the NOTE command would be Included and executed. If BADNEWS were substituted 
for PI, the .IF statement would be false, resulting in the execution of the REVERT command 
and then of the DISPLAY command. 
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ORDER OF EVALUATION 

The order in which operators in an expression are evaluated is: 

1. Exponentiation. 

2. Multiplication, division. 

3. Addition, subtraction, negation, concatenation. 

4. Relations. 

5. NOT. 

6. AND. 

7. Inclusive OR. 

8. Exclusive OR, equivalence. 

Operators of equal order are evaluated from left to right. 


OPERANDS 

One or more operands separated by operators make up an expression. Expressions are used 
within the IF, WHILE, DISPLAY, and SET commands. An expression within an expression must 
begin with a left parenthesis and end with a right parenthesis. There is no limit on the 
length of an expression, except that a period or a right parenthesis (not acting as a 
command terminator) must appear within the first 50 operands. Expressions can contain 
operands of one or more types. There are three types of operands: constants, symbolic 
names, and functions. 


CONSTANTS 

A constant is a string of 1 to 10 characters that the system processes as an integer. The 
constant can be a numeric string or a literal. 


Numeric Strings 

Each character in the string must be a digit (0 through 9), except the final character. The 
final character can be a postradix of D or B to indicate the number base of the constant. A 
postradix of B denotes an octal integer. D or an omitted postradix denotes a decimal 
integer. 


Literals 

A literal is a $-delimited string of characters or a string containing a $-delimited 
string. The literal can be a null string ($$). The maximum length for a literal is 10 
characters, unless it appears within the STR function, in which case it may be any length up 
to the maximum length of the line. 
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Special characters can appear in literals but they must appear in the $-delimited portion of 
the string. To represent a dollar sign within a literal, you must use double dollar signs. 


Valid Literal 

$LIXERAL1$ 

$5LITERAL$ 

$*LITERAL$ 

$$$LITERAL$ 

$$$$ 


Invalid Literals 

LITERALl 

$LITERAL2 

LITERALS$ 

*$LITERAL$ 

$$*LITERAL$ 

$$LITERAL$ 

$$$ 


When a literal appears as an operand in a command, a function, or an expression, the system 
processes it as an integer whose value is equal to the display code representation of the 
literal value rather than as a character string. 


A non-numeric string that appears in an expression to be evaluated must be entered as a 
literal; otherwise, the system treats it as an erroneous symbolic name. 

Example. 

/IF,AFILE.EQ. AF ILE,LABEL. 

CCL157- UNKNOWN NAME - AFILE 


The above command will execute successfully if the file names are entered as literals 
(that is, as integer values): 


/I F, $AF ILE $. EQ. $AF ILE LAB EL. 

When you instruct the system to display or compare the value of a literal string, the system 
right-justifles the display code value of the string and treats it as a numeric value. If 
the string is the result of the STR, STRB, or STRD function, it is left-justified and 
treated as a character string. As a result of this different treatment, a literal string 
within the STR function does not compare equally with the same literal string outside the 
STR function. In other words, STR($ABC$) is not equal to $ABC$. 

Example: 

/display,$lit$ 

49748 141124B 

/display^SaS 
1 IB 

/display,! 

1 IB 

/display,$1 $ 

28 34B 

/display,$$$$ 

43 53B 

/display,literal 

CCL157- UNKNOWN NAME - LITERAL 
/display,STR{$REALLY A STRINGS). 

REALLY A STRING 
/ 
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As noted in the previous example (DISPLAY,LITERAL), nonntimeric strings that are not 
$-deliinited cannot appear as operands. If they appear as such, the system treats them as 
erroneous symbolic names. You can, however, use such strings as parameter values for 
procedures. 


SYMBOLIC NAMES 

A symbolic name is a system-defined string of characters to which the system or you can assign 
a value. The symbolic names represent job or system attributes. You can ascertain and 
sometimes change these attributes by using these symbolic names (refer to the various commands 
and functions described later in this section). 

The following lists contain the valid symbolic names and a brief description of each. The 
lists do not contain the symbolic names you can use with the FILE and DT functions. Those 
symbolic names appear with the descriptions of the functions. 

• Symbolic names whose values are passed to, but not from, a procedure (refer to section 
4). When a procedure reverts, it is restored to the value it held when the procedure 
was called. 

Name Description 

DSC Flag determining whether skipped commands are entered in the dayfile 

(refer to SET Command in this section). 

EF Previous error flag. 

R1 Control register 1 contents. 

R2 Control register 2 contents. 

R3 Control register 3 contents. 

• Symbolic names whose values you can set with the SET command. Some of these symbolic 
names can also be set by the SETJCI macro (refer to Volume 4, Program Interface). 

Name Description 

DSC Flag determining whether skipped commands are entered in the dayfile.t 

EF Previous error flag. 

EFG Global error flag. 

EM Current exit mode (refer to MODE Command, later in this section). 

PD Page density (default = 6 lines per inch; allowable values are 6 or 

8 ) . 

PL Page length (default = 60 lines; minimum = 16, maximum = 255). 

PS Page size (same as page length). 


f The initial value of this symbolic name is zero. 
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Name 


PW 

R1 

RIG 

R2 

R3 

SS 

Symbolic names 
Name 
CMN 

CS 

CSET 

DATE 

DATE 4 

DAY 

DAYS 

ECN 

EF 

FAMILY 

FL 

HID 

JSN 

MFL 

MFLL 

MONTH 

NWK 


Description 

Page width (default = 136 characters; minimum = 40, maximum = 255). 
Control register 1 contents. ^ 

Global control register 1 contents.^ 

Control register 2 contents.t 
Control register 3 contents.t 
Subsystem for an interactive job. 
whose values are set by the operating system. 

Description 

Central memory RFL setting divided by IOO 3 (refer to RFL Command in 
section 7). 

Connection status. 

Terminal character set mode (NORMAL=0 or ASCII=1). 

The current date in the form yymmdd. 

The current date with a 4-digit year, in the form yyyymmdd. 

The day of the month. 

Number of days since January 1, 1977. 

Extended memory RFL setting divided by IOOO 9 (refer to RFL Command in 
section 7). 

Previous error flag. 

Current family name. 

Current CM field length. 

Two-character machine identifier ( 6 -bit display code). 

Four-character job sequence name that uniquely identifies this job ( 6 - 
bit display code). 

Maximum CM field length. 

Maximum extended memory field length. 

The month of the year. (January = 1, February = 2, etc.) 

Networ]c type. Possible values for NWK are: 

0 = Terminal not connected to NAM. 

1 = Terminal connected to NAM/CCP. 

2 = Terminal connected to NAM/CDCNET. 


t The initial value of this symbolic name is zero. 
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Name 


Description 


OT Job origin type. 

PACK Current pack name. 

PfDT Permanent file device type (DJI, DL2, and so on) possibly set by the 

PACKNAM command. 

SC Service class of the job. 

SL Terminal display mode (LINE or SCREEN). 

SPS System page size (in lines). 

SPW System page width (in characters). 

SPD System page density (in lines per inch). 

SSM Operating system security mode (0 means unsecured; 1 means secured). 

SYS Host operating system. 

TIME Current time of day (hhmm). 

TN Terminal name associated with the network line used to access the 

system (6-bit display code). If no terminal name is associated with 
the job (as in the case of a batch job, a detached job, or a non¬ 
network job), a null string (binary zero) is returned. 

UI User index associated with the current user name. 

UJN User job name assigned to this job. It defaults to the user index 

hash for interactive jobs, or it may be set by SETJOB or by the UJN 
paraimeter of the ROUTE command for batch jobs initiated by ROUTE. 

VER Operating system version number (6-bit display code). 

VERCCL CYBER Control Language release level. 

USER Current user name. 

WEEKDAY The day of the week (Monday = 1, Tuesday = 2, etc.) . 

YEAR The current year (last two digits only). 

YEAR4 The current year (all four digits). 

Symbolic name whose value is set by the calling or termination of a procedure. 

Name Description 


PNL 


Procedure nesting level (0 when processing the original command 
record, 1 when processing a first level procedure, and so forth)1 Its 
maximum value is 50. 


Symbolic name whose value can be set by the termination of a procedure (refer to SET 
Command in thi section). 


Name 


Description 


EFG 


Global error flag. 
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Symbolic names with fixed values that can be compared with the error flag value (EF or 
EFG) within an expression. These values correspond to error code values. In an 
expression, you can check the error flag (EF) for a nonzero value. A nonzero value 
indicates an error, and a zero value indicates no error. For detailed error 
examination, you can compare EF with a particular symbolic name or its error code 
value. You are encouraged to use the symbolic name, because the numeric values can 
change in furture releases of NOS. The following list contains the errors that allow 
exit processing. 


Name 

Value (Octal) 

Description 

ARE 

3 

Arithmetic error. 

CPE 

7 

CPU abort. 

DRE 

37 

Deadstart rerun. 

ECE 

30 

Extended memory parity error. 

FLE 

16 

File limit error. 

FSE 

22 

Forced error; set by operator entry of 
utility. 

IDE 

25 

Idledown. 

ITE 

4 

SCP invalid transfer address. 

JSE 

41 

Job step cdjort. 

MLE 

14 

Message limit. 

MXE 

47 

McLximum number of error flags. 

ODE 

24 

Operator drop. 

OKE 

35 

Operator kill. 

ORE 

46 

Override error condition. 

PCE 

10 

PPU call error. 


11 

Reserved for installation. 

FEE 

44 

CPU parity error. 

FPE 

6 

PPD abort. 

PSE 

5 

Program stop error. 

RAE 

40 

Recovery adjort. 

RCE 

23 

Job hung in auto recall. 

RRE 

34 

Operator rerun. 

RSE 

31 

Recovered system (level 3). 

SFE 

26 

Reserved for your site. 

SRE 

20 

SRU limit error. 
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Name 


Value (Octal) 


Description 


SSE 

32 

Subsystem aborted. 

STE 

27 

Suspension timeout 

SVE 

42 

Security conflict. 

SWE 

45 

Software error. 

SYE 

43 

System abort. 

TAE 

2 

User break 2. 

TIE 

1 

User break 1. 

TKE 

17 

Track limit error. 

TLE 

15 

Time limit error. 
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• Symbolic names with fixed values that can be compared with the job's connection 
status (CS) value within an expression. 


Name 

Value 

Description 

NICS 

0 

Not interactive. 

DTCS 

1 

Detached. 

OLCS 

2 

Online. 


Symbolic names with fixed values that can be compared with the terminal character 
set-mode (CSET) value within an expression. 

Name Value Descrlpticin 

NORMAL 0 Uppercase characters only. 

ASCII 1 Uppercase and lowercase characters. 

Symbolic names with fixed values that can be compared with the month of the year 
(MONTH) value within an expression. 

Name Value Description 

JAN 1 January. 

FEB 2 February. 

MAR 3 March. 

APR 4 April. 

MAY 5 May. 

JUN 6 June. 

JUL 7 July. 

AUG 8 August. 

SEP 9 September. 

OCT 10 October. 

NOV 11 November. 

DEC 12 December. 
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• Symbolic names with fixed values that can be compared to the terminal's network 
connection (NWK) value within an expression. 

Name Value Description 

NONE 0 Terminal has no NAM connection. 


CCP 

1 

Terminal is connected using NAM/CCP. 

CDCNET 

2 

Terminal is connected using NAM/CDCNET. 

S3anbolic names with fixed values that can be compared with the origin type (OT) 
value within an expression. 

Name 

Value 

Description 

ECO 

1 

Local batch origin. 

lAO 

3 

Interactive origin. 

RBO 

2 

Remote batch origin. 

SYO 

0 

System origin. 


• Symbolic names with fixed values that can be compared with the service class (SC) 
value within an expression: 


Name 

Value 

Description 


SYSC 

1 

System service class. 


BCSC 

2 

Local batch service class. 


RBSC 

3 

Remote batch service class 

• 

TSSC 

4 

Interactive service class. 


DISC 

5 

Detached interactive service class 

NSSC 

6 

Network supervisor service 

class. 

SSSC 

7 

Subsystem service class. 


MASC 

10 

Maintenance service class. 


CTSC 

11 

Communication task service 

class. 

lOSC 

12 

Installation service class 

0. 

use 

13 

Installation service class 

1. 

I2SC 

14 

Installation service class 

2. 

I3SC 

15 

Installation service class 

3. 

DSSC 

77 

Deadstart service class. 
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S 3 nmbolic names with fixed values that can be compared with the terminal display mode 
(SL) value within an expression. 


Name 

LINE 

SCREEN 


Value 

0 

1 


Description 


Line mode. 
Screen mode. 


Symbolic name with a fixed value that can be compared with the host operating system 

Description 


(SYS) value within an expression. 
Name Value 


NOS 

NOSE 

SC2 


Network Operating System. 

Network Operating System/Batch Environment. 
SCOPE 2 Operating System. 


Symbolic names with a fixed value that you can compare with the subsystem for an 
interactive job (SS). 

Description 


Name 

Value 


ACCESS 

6 

The 

BASIC 

1 

The 

BATCH 

5 

The 

EXECUTE 

4 

The 

FORTRAN 

2 

The 

FTNTS 

3 

The 

NULL 

0 

The 
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• Symbolic names with true or false values. True Is 1; false Is 0 


Name Description 

F Fixed value of 0 (false). 

FALSE Fixed value of 0 (false). 

SWn One of six sense switches (n can be from 1 to 6). Their values 

are set by the OFFSW, ONSW, and SWITCH commands (refer to section 
7). 

T Fixed value of 1 (true). 

TRUE Fixed value of 1 (true). 

• Symbolic names with fixed values that can be compared with the day of the week 
(WEEKDAY) value within an expression. 


Name 

Value 

Description 

MON 

1 

Monday. 

TUE 

2 

Tuesday. 

WED 

3 

Wednesday. 

THU 

4 

Thursday. 

FRI 

5 

Friday. 

SAT 

6 

Saturday. 

SUN 

7 

Sunday. 


FUNCTIONS 

Functions are used as expressions or operands within expressions In commands. Functions are 
not commands. The functions are FILE, DT, LEN, LVL, NUM, STR, STRB, and STRD. 


FILE Function 

The FILE function determines whether a local file has a specified attribute. The system 
returns a value of 1 (true) or 0 (false) depending upon whether the file has or does not 
have the specified attributes. Only the equipment number (EQ) and file size (FS) attributes 
can return values other than 1 or 0. The list of file attributes follows the description of 
the FILE function fomat. 

The FILE function must be used as an expression or as a part of an expression In a command. 

A left parenthesis must appear before the file name, a comma must appear between the file 
name and the expression, and a right parenthesis must appear after the expression. 
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Foraat: 


FILEdfn,expression) 

^Meter Description 

Ifn Name of the local file for which attributes are being determined. 

expression Either a special FILE function attribute or an expression, consisting 
of logical operators and special FILE function attributes. The 
expression must be appropriate for the command in which the FILE 
function appears. If the FILE function is part of an IF command or 
.IF directive, the expression should be one chat can be evaluated as 
true or false. If the FILE function is part of the DISPLAY command, 
the expression could have a numeric value other than a true or false 
value. 

The expression within a FILE function cannot include the NUM function, 
the symbolic name SS, or another FILE function. The DT function or 
the following symbolic names can be used within the expression. 


Parameter Description 

AP File has append permission. 

AS File is assigned or attached to your job. 

BOI File is positioned at BOI. This is effective only for 

a file on mass storage. 

EOF Last operation was a forward operation, which 

encountered an EOF and is now positioned at that EOF. 
This is effective only for a file on mass storage. 

EOI Last operation was a forward operation, which 

encountered an EOI and is now positioned at that EOI. 
This is effective only for a file on mass storage. 

EQ EST ordinal of the equipment on which the file 

resides. If the file is not assigned to a device, it 
has an EST ordinal of zero. 

EX File has execute permission. 

FS File size in PRUs. 

GL File is a global library. 

IN File type is input. 

LB File is on a labeled tape. 

LI File is a system library file. 
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Parameter 


Description 

LO 

File 

type is local. 

MD 

File 

has modify permission. 

MS 

File 

is on mass storage. 

OP 

File 

is opened. 


PM 

File 

is an attached direct access permanent file 

PT 

File 

type is primary. 

QF 

File 

type is queued. 

RA 

File 

has read append permission. 

RD 

File 

has read permission. 

EM 

File 

has read modify permission. 

RU 

File 

has read update permission. 

TP 

File 

is on magnetic tape. 

TT 

File 

is assigned to a terminal. 

UP 

File 

has update permission. 

WR 

File 

has write permission. 

ZL 

File 

has zero length. 


Any other symbolic name within the expression is treated either as an implicit DT function 
(refer to DT Function, which follows) or as an unidentified variable. 

Example: 

The following job segment shows the FILE function being lased Inside an IF command. The FILE 
function determines if file ACCT is not at the beglnning-of-information (BOI). If ACCT is 
not at BOI, the IF command is true and the system rewinds ACCT before copying it onto ITEM. 
If ACCT is at BOI, the IF command is false and the system skips to the EMDIF command and 
copies ACCT onto ITEM. In both cases, ACCT is copied to ITEM and is replaced. 

IF,FILE(ACCT,.N0T.B0I),LABEL1. 

REWIND^ACCT. 

ENDIF,LABEL1. 

COPY,ACCT,ITEM. 

REPLACE,ITEM. 


DT Function 

The DT function determines the device type on which a file resides. DT can be used only 
within a FILE function. The value of the DT function is true if the two—character mnemonic 
Included in the function is equal to the two—character device type. The operating system 
defines the mnemonics. 


6-14 


60459680 K 




Format: 


FILE(lfn,DT(dt)) 
Pareuneter 
Ifn 
dt 


Description 

Name of the file for which device residence is being determined. 

A two-character mnemonic identifying the device, which may be any one of 
the following: 

Type Kouipment 

AT Cartridge tape drive for ACS. 

CT Cartridge tape drive for CTS. 

DB 885-42 Disk Storage Subsystem. 

DC 895-1/2 Disk Storage Subsystem. 

DD 834 Disk Storage Subsystem. 

DE Extended memory. 

DF 887 Disk Storage Siibsystem {4K sector) . 

DG 836 Disk Storage Subsystem. 

DH 887 Disk Storage Subsystem (16K sector) . 

DI 844-21 Disk Storage Subsystem (half-track) . 

DJ 844-41/44 Disk Storage Subsystem (half-track). 

DK 844-21 Disk Storage Subsystem (full-track) . 

DL 844-41/44 Disk Storage Subsystem (full-track). 

DM 885-11/12 Disk Storage Subsystem (half-track). 

DN 9853 Disk Storage Subsystem. 

DP Distributive data path to extended memory. 

DQ 885-11/12 Disk Storage Subsystem (full-track). 

DV 819 Disk Storage Subsystem (single-density) . 

DW 819 Disk Storage Subsystem (double-density) . 

EA 5830 Disk Array Subsystem; one 5832 SSD drive used in 

serial mode. 

EB 5830 Disk Array Subsystem; two 5832 SSD drives used in 

parallel mode. 
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Type 

Eouinment 



EC 

5830 Disk Array Subsystem; one-5833 
serial mode. 

SABRE 

drive used in 

ED 

5830 Disk Array Sijbsystem; two 5833 
for data and one for parity. 

SABRE 

drives: one 

EE 

5830 Disk Array Subsystem: two 5833 
parallel mode. 

SABRE 

drives used in 

EF 

5830 Disk Array Subsystem: three 5833 SABRE drives: two 
for data and one for parity. 

MT 

7-track tape drive. 



NE 

Null equipment. 



NT 

9-track tape drive. 



TT 

Interactive terminal. 




The following dayfile segment shows that TAXES is on a nine-track magnetic tape, so it is 
copied to output and then imloaded. If the DT function was false, TAXES would be unloaded 
without being copied. 


14.00.45.IF,FILE(TAXES,DT(NT)),LABL1. 
14.00.46.COPY,TAXES,ODTPOT. 
14.00.46.EOI ENCOUNTERED. 

14.00.46.ENDIF, LABLl. 

14.00.46 .UNLOAD,TAXES . 
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LEN Function 


The LEN function returns the length of a specified string. 

Format; 

LEN(string) 

Parameter Deseription 

string A string of amy length up to the maximum length of a line. If the 

string is a literal, the length returned is the length of the string 
after the removal of the surrounding dollar signs ($) and of any extra 
dollar signs within the string. 


LVL Function 

The LVL function returns the PSR level (or equivalent) for the NOS operating system or the 
CYBER Control Language. 

Format: 


LVL(name) 

Parameter 

naune 


Description 

Specifies one of the following symbolic values: 


name 

SYS 

NOS 

CCL 


Description 

Networlt Opez^ating System 
Network Operating System 

CYBER Control Language, the set of commands that 
determines the processing sequence within the commauid 
record 


Default is SYS. Symbols for other operating systems that use the CYBER 
Control Language eure recognized, but return a value of zero. 
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NUM Function 


The NUM function determines whether a character string is numeric. It evaluates the 
character string as true (1) if it is numeric or false (0) if it is not. NUM must be used 
as an expression or as part of an expression. 

Format: 

NUM(string) 

Parameter Description 

string A string of 1 to 40 characters. If the string contains one or more 

special characters, it must be delimited by dollar signs (for example, 
§***$). If delimited by dollar signs, the string is always evaluated 
as non-nimieric. 

Example: 

The following procedure uses the NUM function to ensure that the passed parameter, NUMBER, 
is numeric. If a non—numeric value is passed, the procedure terminates with an appropriate 
message. 

.PROC,PROC1*I,NUMBER. 

.IF,NUM(NUMBER),QUIT. 

WHILE,R1.LE.NUMBER,L00P. 

SET,R1=R1+1. 


ENDW,LOOP. 

REVERT. PROCESSING COMPLETED 

.ENDIF,QUIT. 

REVERT,AB0RT. NONNUMERIC PASSED 

STR Function 

The STR function produces a left-justified string of any length up to the maximum line 
length. The STR function makes it possible to manipulate character strings greater than 10 
characters in length. An STR function result may be compared or combined with the results 
of STRB, STRD or other STR functions in a variety of ways. 

Format: 

STR(strexp,lc,rc) 

PaX-affleter Description 

strexp May be any legal expression, usually but not necessarily a literal. 

Literals are left-justified, and may be any length up to the maximvnn 
line length. Nonliteral values are treated normally during evaluation 
of the expression. However, a numeric result will be left-justified 
and treated as a string. 

Ic Must be an expression producing a numeric result, either positive or 

negative. Ic indicates which character of strexp is to be the 
leftmost character of the string produced by STR, counting from the 
left if Ic is positive or from the right if negative. A value of zero 
or a negative value which exceeds the length of strexp is treated as 
equivalent to 1. A positive value greater than the length of strexp 
produces a null string. Ic may be omitted if it would reference the 
leftmost character of strexp and if rc is also omitted. (The 
preceding comma must also be omitted when Ic is omitted.) 


60459680 K 


6-16.1 



Parameter 


Description 


rc Must be an expression producing a numeric result, either positive or 

negative, rc indicates which character of strexp is to be the 
rightmost character of the string produced by STR, counting from the 
left if rc is positive or from the right if negative. A positive 
value greater than the length of strexp is considered equal to the 
length. A value of zero or a negative value which exceeds the length 
of strexp produces a null string, rc may be omitted if it would 
reference the rightmost character of strexp. (The preceding comma 
must also be omitted when rc is omitted.) 

In summary, Ic and rc both reference the string strexp in the same 
way: a positive value of n indicates the nth character of strexp 
counting from the leftmost character, 1 meaning the first character. 

A negative value of -n Indicates the nth character of strexp counting 
from the rightmost character, -1 meaning the last character. 

Example: 

The following expressions all produce the same result, the string $ABET$. 

STR($ALPHABETAG$,5,-3) 

STR($ALPHABETAG$,-6,8) 

STR($ALPHABET$,5) 

STRB Function 

The STRB function produces a left-justified string of 1 to 17 characters 

representing the octal value of a specified expression. 

Format: 

STRB(numexp,1c,rc) 

garameter Description 

numexp May be any legal expression, usually but not necessarily numeric. If 

numexp is or contains a literal, the literal is limited to no more 
than 10 characters and is right-justified and binary-zero filled for 
evaluation. 

The result produced by numexp is treated as a one-word signed value 
and is converted to a character string in octal. For example, the 
decimal value 25 for numexp would result in the string $31$. 

Ic Specifies which character of numexp is to be the leftmost in the 

resulting string. For further explanation of this parameter, refer to 
the description of the STR function. 

rc Specifies which character of numexp is to be the rightmost in the 

resulting string. For further explanation of this parameter, refer to 
the description of the STR function. 

Example: 

Each of the following expressions produces the string $102$. 

STRB($ABC$,-5,-3). 

STRB(10203B,-5,-3). 


6-16.2 


60459680 K 




STRD Function 


The STRD function produces a left-justified string of 1 to 16 characters representing the 
decimal value of a specified expression. 

Format: 

STRD(numexp,1c,rc) 

®?£?.F.ijption 


numexp May be any legal expression, usually but not necessarily numeric. If 

numexp is or contains a literal, the literal is limited to no more 
than 10 characters and is right-justified and binary-zero filled for 
evaluation. The result produced by numexp is treated as a one-word 
signed value, and is converted to a character string in decimal. For 
example, the decimal value 25 for numexp would result in the string 
$25$. 

Ic Specifies which character of numexp is to be the leftmost in the 

resulting string. For further explanation of this parameter, refer to 
the description of the STR function. 

rc Specifies which character of numexp is to be the rightmost in the 

resulting string. For further explanation of this parameter, refer to 
the description of the STR function. 

Example: 

The following expression produces a string of $0012$. 

STRD(10000+36/3,-4). 


COMMAND DESCRIPTIONS 

Individual descriptions of the commands follow in alphabetic order. 


BEGIN COMMAND 

Refer to Calling a Procedure in section 4. 
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DISPLAY COMMAND 


The DISPLAY command evaluates an expression and sends the result to the job dayfile in both 
decimal and octal integer form or in character string form, depending on the expression. 

(If the expression is an STR, STRB, or STRD function or a concatenation thereof, the 
resulting string is displayed as a character string; otherwise, the decimal and octal 
integer format is used.) The largest decimal value which can be displayed is 10 digits. If 
the value is larger than 10 digits, GT followed by 9999999999 is displayed. If the value is 
negative and larger than 10 digits, LT followed by a minus and 9999999999 is displayed. In 
octal code, numbers as large as 16 digits can be displayed. For an expression larger than 
2^®-l, zeros are displayed. 

Format; 

DISPLAY,expression]^ ,expression 2 , . . . ,expressionjj. 

Parameter Description 

expression] Specifies any valid symbolic name or expression described earlier in 
this section. 


Example: 

The following sample dayfile shows several display operations. 


12. 53.18. DISPLAY,!IME. 

12.53.18. 1253 2345B. 

12.53.27.SET,R1,=99. 

12.53.40. SET,R2, =901. 

12. 54.05.DISPLAY,R1. 

12.54.05 . 99 1 43B. 

12.54.16. D1SPUY,R1+R2. 

12.54.16. 1000 1 750B. 

12.55.09. DISPLAY,STR (SNOW IS THE TIMES). 

12.55. 09. NOW IS THE TIME. 

12.56.10. DIS PU Y,STRB (R1 +R2) . 

12.56.10.1750. 

12. 56. 26. DIS PLA Y, STR 0 (R1 -H? 2) . 

12.56.26.1000. 

12.58.26.DISPLAY,STRB(R1+R2)//STR(SB IS EQUAL TO S)//STRD(R1+R2). 
12.58.26.175CB IS EQUAL TO 1000. 

13.01.32. DISPLAY,STR (SFIRSTRATE$,4,6)//STR (SRINGERS,2,4). 

13.01.32. STRING. 

13.01.53. DIS PLAY, 3/2. 

13.01.53. 1 IB 

13.02.07. DIS PL A Y, 2**4 7. 

13.02.07. GT 9999999999 4000000000000000B. 

13.02.2 4. D IS PLA Y, -2 **4 7. 

13.02.24. LT -9999999999 -4000000000000000B. 

13.02.3 8. DIS PLA Y,2 **48. 

13.02.38. 0 OB. 

13.03.2 8. DIS PLA Y, 99999999999. 

13.03.28. CCL156- STRING TOO LONG - 99999999999 
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The first DISPLAY command displays the value of the symbolic name TIME. The current time 
given is in the form hhmm. The next six lines demonstrate the use of the R1 and R2 symbolic 
names. The next 10 lines illustrate the use of the STR, STRB, and STRD functions for 
generating display character strings. The other DISPLAY commands specify numeric 
expressions. The integer constant in the final DISPLAY command has more than 10 digits, 
resulting in an error message. 


BSE COMMAND 

The ELSE command performs one of the following functions. 

• It terminates skipping initiated by a false IF or ELSEIF command whose label string 
matches that of the ELSE command. If the label string does not match, the ELSE 
command is skipped. 

• It initiates skipping from the ELSE command to the ENDIF command whose label string 
matches that of the ELSE command. This happens for a true IF or ELSEIF command. 

Neither a SKIP nor an ELSE command terminates skipping initiated by another SKIP or ELSE 
command. 

Format: 

ELSE,label. 

Parameter Description 

label Specifies a 0- to 10-character alphanumeric string. The string must 

begin with an alphabetic character. 

Example: 

The following commands use the FILE function to determine if a file named TESTl is local to 
the job. If the file is local, it is copied to the OUTPUT file. If it is not, it is 
assumed to be an indirect access permanent file, and a local copy is obtained and.copied to 
OUTPUT. 
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If the file is local, each succeeding command, up to the ELSE command, is processed, and the 
ELSE command initiates a skip to the ENDIF command. If the file is not local, control skips 
to the ELSE command, and each command succeeding the ELSE command is processed. 


IF,FILE(TEST1,L0),LABEL1. 

C0PYSBF,TEST1,0UTPUT. 

ELSE,LABEL1. 

GET,TEST1. 

C0PYSBF,TEST1,0UTPUT. 
ENDIF,LABEL1. 


The following dayfile segment results when the preceding commands are processed and TESTl is 
not initially a local file. 


11.33.00.IF,F1LE(TEST1,L0),LABEL1. 

11.33.00.ELSE,LABEL1. 

11.33.00.GET,TEST1. 

11.33.00.COPYSBF,TEST1,0UTPUT. 

11.33.01.END OF INFORMATION ENCOUNTERED. 
11.33.01.ENDIF,LABEL1. 


The following dayfile segment results when the preceding commands are processed and TESTl is 
initially a local file. 


15.40.19.IF,FILE(TEST1,L0),LABEL1. 

15.40.19.C0PYSBF,TEST1,OUTPUT. 

15.40.21. END OF INFORMATION ENCOUNTERED. 

15.40.21. ELSE,LABEL1. 

15.40.21. ENDIF,LABEL1. 


ELSEIF COMMAND 

The ELSEIF command in conjunction with a preceding IF (or ELSEIF) command terminates or 
initiates the skipping of commands. 

Format: 

ELSEIF,condition,label. 

Parameter Description 


condition Specifies an expression that is either true of false. 

label Specifies a 1- to 10-character alphanumeric string that must begin 

with an alphabetic character. An identical label must appear on a 
subsequent ELSE, ELSEIF, and/or ENDIF command. 

If the most recent matching IF or ELSEIF condition was true, the ELSEIF command functions 
as a ELSE command; that is, the statements between the ELSEIF and the next matching ENDIF 
command are skipped. If the most recent matching IF or ELSEIF condition was false, the 
system stops skipping lines and evaluates the ELSEIF condition: 

• When the ELSEIF condition is true, no more lines are skipped and the system 
processes the statements between the ELSEIF connamd and th next matching ELSE, 
ELSEIF, or ENDIF. 

• When the ELSEIF condition is false, the system skips te lines between the ELSEIF 
command and the next matching ELSE, ELSEIF, or ENDIF command. 
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Example: 


The following commands test for the presence of one of three files, returning only the first 
one found: 

IF, FILE(A,AS),BEGONE. 

RETURN,A. 

ELSEIF,FILE <B,AS),BEGONE 
RETURN,B. 

ELSEIF,FILE(C,AS),BEGONE. 

RETURN,C. 

ELSE,BEGONE. 

N0TE.+ NO FILE TO BE RETURNED 
ENDIF,BE60NE. 


ENDIF COMMAND 

The ENDIF command terminates skipping initiated by a SKIP, IF, or ELSEIF command. In all 
cases, the label string on the ENDIF command must match the label string on the command that 
initiates the skipping. If the system encounters an ENDIF command with a nonmatching label 
string, it ignores that command. 

Format: 

ENDIF,label. 

Parameter Description 

label Specifies a 0- to 10-character alphanumeric string. The string must 

begin with an alphabetic character. 
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Example: 


When the SKIP command in the following sequence of commands is processed, control skips to 
ENDIF, and none of the commands between SKIP and ENDIE are processed* 

SKIP,LABEL1. 


commands 


ENDIF,LABEL1. 


ENDW COMMAND 

The ENDW command Identifies the end of the WHILE command loop* A command loop is a sequence 
of commands that may be repeatedly processed* The number of times the loop is processed 
depends on the evaluation of the expression specified in the WHILE command that begins the 
loop* 

The ENDW command must have a label string that matches the label string specified in the 
WHILE command that begins the loop* 

Format: 

ENDW,label* 

Parameter Pe.sjcxlBt.lon 


label Specifies a 0- to 10-character alphanumeric string* The string must 

begin with an alphabetic character* 

Refer to WHILE Command in this section for an example of ENDW command use. 


EXIT COMMAND 

The EXIT coounand indicates the position in the command record where processing will resume 
if an error is encountered prior to the EXIT command* If no error is encountered, the EXIT 
command indicates where to terminate normal command processing* 

When used in procedures, we recommend that the EXIT command be preceded by a SKIP or REVERT 
command to prevent execution of the EXIT command in the case where no error occurs* An EXIT 
command executed in this way terminates the executing procedure as well as all calling 
procedures if nesting has occurred, but does not restore control registers to their previous 
values * 

Format: 

EXIT* 

For additional information, refer to the description of the NOEXIT and ONEXIT commands later 
in this section and to the description of exit processing in section 5* 
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IF (OR IFE) COMMAND 

Ihe IF conunand conditionally skips one or more commands. 
Formats; 


IF,expression.command. 
IF,expression,label. 


Parameter 


Description 


expression Specifies an expression that is either true or false. The separator 
following expression in the first format must be a terminator. 

command Specifies a valid command. 

label Specifies a 0- to 10-character alphanumeric string. The string must 

begin with an alphabetic character. An identical string must appear in 
a subsequent ELSE, ELSEIF or ENDIF command. 


The first format conditionally skips only the command specified within the IF command. If 
expression is true, the system executes the specified command. If expression is false, the 
system skips the command. 


NOTE I 


When using the first format (IF,expression, 
command.), values for .command, that match a 
relational, logical, or string operator 
(such as .EQ. or .OR.) are interpreted as 
operators, causing the procedure to abort. 

To write a valid IF command when .command, 
matches an operator, terminate the expression 
or command with a right parenthesis instead 
of a period. 


The second format conditionally skips all commands between the IF command and the first 
matching ELSE, ELSEIF or ENDIF command (two commands match if their label parameters are 
identical). If expression is true, the system executes all commands between the IF and the 
matching ELSE, ELSEIF or ENDIF. If expression is false, the system skips all intervening 
commands. 

Example 1: 

The following commands initiate the compilation and execution of a FORTRAN program and then 
test for any errors during execution. If an error was made, the error code is displayed. 

FTN5,I=IFTEST. 

SET,EF=0. INITIALIZE ERROR FLAG 
NOEXIT. 

LGO. 

ONEXIT. 

IF,EF.NE.O.DISPLAY,EF. 

If the job step executes without error, the error flag (EF) is 0. In this case, the DISPLAY 
command is not executed. If an error occurs, the error flag is not 0, expression is true, 
and control passes to the DISPLAY command. The system then displays the error code in the 
error flag register. (The NOEXIT and ONEXIT commands are described later in this section.) 
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In the following example, the FORTRAN program FTNPROG attempts to call a subroutine BETA 
which does not exist (outside the field length of the job). The commands that are used 
appear first and the dayfile segment follows. 


FTN5,I=FTNPR0S. 

SET,EF=0. INITIALIZE ERROR FLAG 
NOEXIT. 

L60. 

ONEXIT. 

IF,EF.NE.O.DISPLAY,EF. 

12.57.02.FTN5,I=FTNPR0G. 

12.57.02. 61000 CM STORAGE USED. 

12.57.02. 0.009 CP SECONDS COMPILATION TIME. 

12.57.02.SET,EF=0. INITIALIZE ERROR FLAG 
12.57.02.NOEXIT. 

12.57.02.LG0. 

12.57.03. NON-FATAL LOADER ERRORS - 
12.57.03. UNSATISFIED EXTERNAL REF —• BETA 
12.57.03. MODE ERROR. 

12.57.03. JOB REPRIEVED. 

12.57.03. UNSATISFIED EXT IN FLAG NEAR LINE 2 
12.57.03. 7500 MAXIMUM EXECUTION FL. 

12.57.03. 0.000 CP SECONDS EXECUTION TIME. 

12.57.03. RPV - PREVIOUS ERROR CONDITIONS RESET. 
12.57.03. CPU ERROR EXIT AT 400121. 

12.57.03. CM OUT OF RANGE. 

12.57.03.ONEXIT. 

12.57.04.IF,EF.NE.O.DISPLAY^EF. 

12.57.04.DISPLAY,EF. 

12.57.04. 3 3B 


Example 2: 

The following procedure file is an indirect access file called COLORPR. It uses the IF 
command to determine if the color the BEGIN command substituted for COLOR is red or blue. 
Different processing is done for the colors red and blue. Any other color is Ignored. The 
# character in the comment line inhibits substitution for the word (COLOR) it precedes 
(refer to Parameters and the Procedure Body in section 4). 

.PR0C,A*I,COLOR. 

IF^$C0L0R$.EQ.$RED$,L1. 

CONSENT. PROCESSING DONE FOR ffCOLOR OF COLOR 
REVERT. 

ENDIF,L1. 

IF,SCOLORS.EG.$BLUE$,L2. 

COmENT. PROCESSING DONE FOR #COLOR OF COLOR 
REVERT. 

ENDIF,L2. 

COMMENT. NO PROCESSING FOR #C0L0R OF COLOR 
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The following commands call procedure A. 

BEGIN^A,COLORPR,BLUE. 

BE6IN,A^C0L0RPR,RED. 

BEGIN,A,COLORPR,PINK. 

The following dayfile segment results when the preceding commands are processed. It shows 
the effect of the # character. 


08.34.30.BEGIN,A,COLORPR,BLUE. 

08.34.32.IF,$BLUE$.EG.$RED$,L1. 

08.34.32.ENDIF,L1. 

08.34.32.IF,$BLUE$.ES.$BLUE$,L2. 

08.34.32.COMMENT. PROCESSING DONE FOR COLOR OF BLUE 
08.34.32.REVERT. 

08.34.33.BEG1N,A,C0L0RPR,RED. 
08.34.34.IF,$RED$.EQ.$RED$^L1. 

08.34.34.COMMENT. PROCESSING DONE FOR COLOR OF RED 
08.34.34.REVERT. 

08.34.34.BEGIN,A,C0L0RPR,PINK. 

08.34.35.IF,$PINK$.EGI.$RED$,L1. 

08.34.35.ENDIF^LI. 

08.34.35.IF,$PINK$.EQ.$BLUE$,L2. 

08.34.35.ENDIF,L2. 

08.34.36.COIWENT. NO PROCESSING FOR COLOR OF PINK 
08.34.36.$REVERT.CCL 


MODE COMAAAND 

The MODE command defines the error conditions that cause the system to exit from normal 
processing. When the error that you specified occurs, the system sets the appropriate error 
flag and exits from normal processing to perform any error processing required. If an error 
occurs for which you did not select the exit mode processing, the system ignores the error 
and continues normal processing. 

Format; 


MOD£,m,n. 

Parameter Description 

m CPU program error exit mode (OKmOIg), Modes lOg through 17g are 

only valid for model 176. Selects the error condltion(s) for which 
normal error processing does and does not occur. If no mode is 
selected, the default is 7. 


n 


Included for compatibility with earlier versions of NOS. The system now 
ignores the value specified on the command. 
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The following values can be supplied for m. 


m Normal Error Processing Occurs 

0 None.t 


1 

2 

3 

4 


Address out of range. 

Operand overflow.t 

Address out of range or 
operand overflow. 

Indefinite operand .t 


3 Address out of range or 

Indefinite operand. 

6 Indefinite operand or operand 

overflow. 


7 Indefinite operand, address out 

of range, or operand overflow 
(default value). 

Operand underflow or address out 
of range. 

12 , 13 t+t Operand underflow, address out 
of range, or operand overflow. 


14,15 Operand underflow, address out 

of range, or Indefinite operand. 


16,17 Operand underflow, address out of 

range, operand overflow, or 
Indefinite operand. 


Error Ignored and Job Continues 


Address out of range, operand overflow. 
Indefinite operand, or operand 
underflow.tt 

Indefinite operand, operand overflow, 
or underflow. 

Address out of range. Indefinite 
operand, or operand underflow. 

Indefinite operand or operand 
under f low .t+ 

Address out of range or operand 
overflow or underflow.tt 

Operand overflow or underflow.tt 


Address out of range or operand 
underflow. 

Operand underflow. 


Operand overflow or indefinite 
operand. 

Indefinite operand. 

Operand overflow. 

None. 


tOn the model 176, address out of range (m=l) is always selected, 
tt Operand underflow is applicable only to the model 176. 
tttThese modes are valid only on the model 176. Since address out of range (m*=l) is always 
selected, the two modes are equivalent. 
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Descriptions of the error conditions are as follows: 


Error Condition 


Description 


Address out of range error. An error caused by an attempt to reference central memory or 

extended memory outside of established limits. 

Operand overflow error. An error resulting when a floating-point arithmetic unit 

receives an operand with an exponent value of +1777g (3777 or 
4000 in packed form). This is the largest exponent value that 
can be represented in floating-point format. 


Indefinite operand error. An error resulting when a floating-point aritlmetic unit 

encounters a calculation it cannot resolve. Examples of 
Indefinite operand errors are an attempt to divide 0 by 0 and 
an attempt to multiply an overflow operand by an underflow 
operand. 

Operand underflow error. An error resulting when a floating-point arithmetic unit 

receives an operand with an exponent of -1777g (0000 or 7777 
in packed form). This is the smallest exponent value that can 
be represented in floating-point format. 


For further information about the processing of error mode errors, refer to Error Control in 
section 3. For further Information on the error conditions described above, refer to the 
appropriate CYBEK 180, CYBER 170, CYBER 70, or 6000 Computer System reference manual. 


NOEXIT COMMAND 

The NOEXIT command suppresses EXIT command processing. If an error occurs, control is not 
transferred to the command following the next EXIT command. Instead, processing continues 
with the next command (unless the error causes the job to unconditionally terminate). Refer 
to the description of exit processing in section 5 for more information. 

Format: 

NOEXIT. 


ONEXIT COMMAND 

The ONEXIT command reverses the effect of a NOEXIT command. If an error occurs in 
processing the commands following ONEXIT, control transfers to the command following the 
next EXIT command. Refer to the description of exit processing in section 5 for further 
Information. 

Format: 

ONEXIT. 


REVERT COMMAND 

Refer to Ending a Procedure in section 4. 
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SET COMMAND 


The SET command assigns a value to a control register, an error flag, or the flag that 
determines whether skipped commands are entered in the dayfile. Using the SS symbolic name, 
it also can change the current interactive subsystem. 

F ormat: 

SET,symbolj^=expression 2 ,symbol 2 =expression 2 , . • ., symbol^=expressionjj 
symbolOne of the following symbolic names. 

Name Description 


R1, R2, or R3 Local control registers. When a procedure is 

called, the current values of R1, R2, and R3 are 
passed to the procedure. The values of these 
registers may change within the procedure. 

However, when processing reverts, these registers 
are restored to the values they had when the 
procedure was called. The initial value for each 
is 0. 

RIG Global control register. When a procedure is 

called or reverts, RIG keeps its current value. 

The initial value for RIG is 0. 

EF Local error flag. When a procedure is called, the 

current value of the error flag is passed to the 
procedure. The value of the error flag may change 
within the procedure. However, when the procedure 
reverts, the error flag is restored to the value it 
had when the procedure was called. The initial 
value for EF is 0. 

EFG Global error flag. When a procedure is called or 

reverts, EFG keeps its current value if it is not 
zero. If EFG has a value of zero when the 
procedure reverts, the system sets EFG equal to 
EF. The initial value of EFG is 0. 

DSC Dayfile-skipped-command flag. Initially, it is set 

to 0, so that commands that are skipped (not 
processed) are not entered in the dayfile. If DSC 
is 1, the system enters skipped commands in the 
dayfile with two leading periods. 

PL or PS Page length (or page size). Default is 60 lines. 

PW Page width. Default is 136 characters. 

PD Page density. Default is six lines per inch. 

SS Interactive subsystem indicator. The default of SS 

is NULL. 

expressionj^ Any valid expression. The value derived through evaluation of the 
expression is assigned to the symbolic name. Acceptable values for 
each symbolic name follow. 


60459680 J 


6-25 



symbol 


Suggested Value 


Rl, R2, R3, or RIG Any Integer between -131071 and 131071. If 

the value is outside this range, it is 
truncated. The values in these registers are 
18-bit quantities, 17 digits and a sign. When 
truncation occurs, the upper bits are truncated 
but the sign bit is always retained. The 
system does not issue a message as a resiilt 
of the truncation. 


EF or EFG 


DSC 


PL or PS 

PW 

PD 

SS 


Any integer between 0 and 63. The values in 
these registers are 6-blt unsigned quantities. 
When truncation occurs, the upper bits are 
discarded. If the value is greater than 63, 
it is truncated. To assign the value defined 
by the system for an error condition, set the 
error flag to one of the error condition 
symbolic names (refer to Symbolic Names at the 
beginning of this section). The system sets 
the EF flag to the appropriate error code when 
an error occurs. 

1 or 0. If the value of the expression is 
nonzero, DSC is set to 1. While DSC is 1, 
skipped commands are entered in the dayfile 
preceded by two periods. Some error 
processing routines set DSC to 1 so that 
skipped commands are written in the dayfile. 

Any Integer between 16 and 255. 

Any integer between 40 and 255. 

6 or 8. You can select a print density of 
either six or eight lines per inch. 

Any subsystem name (ACCESS, BASIC, BATCH, 
EXECUTE, FORTRAN, FTNTS, or NOLL). 
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Examples: 


The first three examples use procedures from the following procedure file. It Is an 
Indirect access permanent file with the name SETFILE. 

.PR0C,P1*I. 

DISPLAY,R1. 

0ISPLAY,R1G. 

SET,R1=9. 

SET,R1G=888. 

-EOR- 

.PR0C,P2*I. 

GET,ABC. 

OISPLAY,EF. 

DISPLAY,EFG. 

-EOR- 

.PR0C,P3*I. 

GET,BASIC1. 

BASIC. 

DISPLAY,EF. 

DISPUY,EFG. 

-EOR- 

-EOF- 

Example 1 - Control Register Dse: 

The following commands (below on the left side) set and display registers R1 and RIG. A 
procedure, PI, Is called which displays these registers, resets them, and then reverts to 
the command record where they are again displayed. 

On the right Is the dayflle segment resulting from processing of the commands. 

16.34.42.SET,R1*1. 

16.34.42.SET,R1G=10. 

16.34.43. DISPLAY,R1. 

16.34.43. 1 IB 
16.34.43.0ISPLAY,R1G. 

16.34.43. 10 12B 

16.34.43. BEGIN,P1,SETFILE. 

16.34.44. DISPLAY,R1. 

16.34.44. 1 IB 

16.34.44. DISPLAY,R1G. 

16.34.44. 10 12B 

16.34.44.SET,R1=9. 

16.34.44. R16=888. 

16.34.44.SREVERT.CCL 

16.34.44. DISPLAY,R1. 

16.34.44. 1 IB 

16.34.45. DISPLAY,R1G. 

16.34.45. 888 1570B 

The R1 and RIG registers retain their setting when the procedure is called. However, after 
new values are set in the procedure and control reverts to the command record, Rl returns to 
Its previous value and RIG retains the value set In the procedure. 


SET,R1=1. 

SET,R1G=10. 

DISPLAY,R1. 

DISPLAY,R16. 

BE6IN,P1,SETFILE. 

DISPLAY,R1. 

DISPLAY,R1G. 


60459680 D 


6-27 



Example 2 - Error Flag Use (EFG Nonzero); 


the following commands (below on left side) set values in the error flags EF and EFG and 
then call a procedure which attempts to access an indirect access permanent file. Control 
reverts to the command record where EF and EFG are displayed to see if any error code 
generated is returned via these flags. Cn the right side is the dayfile segment resulting 
from the processing of the commands. 


NOEXIT. 

SET,EF*10. 

SET,EFG=20. 

DISPLAY,€F. 

01SPLAY,£FG. 

BEGIN,P2,SETFILE. 

DISPLAY,EF. 

DISPLAY, EFG. 


16.43.35. NOEXIT. 

16.43.35.SET,EF=10. 

16.43.35,SET,EFG=20. 

16.43.35. DISPLAY,EF. 

16.43.35. 10 12B 

16.43.35. DISPLAY,EFG. 

16.43.35 20 24B 

16.43.35. BEGIN,P2,SETFILE. 
16.43.36.6ET,AB€. 

16.43.36. ABC NOT FOUND. 

16.43.36. DISPUY,EF. 

16.43.36. 6 6B 

16.43.36. DISPLAY,EFG. 

16.43.36. 20 248 

16.43.36.SfiEVERT.CCL 

16.43.37. DISPLAY,EF. 

16.43.37. 10 12B 

16.43.37. DISPLAY,EFG. 

16.43.37. 20 248 


The procedure attempts to get a permanent file which does not exist. This changes EF to 
error code 6. It does not affect EFG. Control reverts to the command record and displays 
EF and EFG, EF returns to its initial setting; EFG remains unchanged throughout. 
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Example 3 - Error Flag Use (EFG Zero): 


To return the error code generated in a procedure to the command record, EFG must be 0 
before there is an exit from the procedure. This is demonstrated by the following commands 
(below left side). 

The dayfile segment (on the right) resulting from processing of the commands shows how the 
error code is returned. 


NOEXIT. 

SET,EF=10. 

SET,EF6=0. 

BEGIN,P3,SETFILE. 

DISPLAY^EF. 

DISPLAY,EF6. 


09 .42.52.NOEXIT. 

09.42.52.SET,EF=10. 

09.42.52.SET,EFG=0. 

09.42.52.BEGIN,P3,SETFILE. 
09.42.53.GET,BASIC1. 

09.42.55.BASIC. 

09.42.56. INPUT FILE EMPTY OR HISPOSITIONED 
09.42.56.0ISPLAY,EF. 

09.42.56. 7 7B 

09.42.57.DISPLAY,EFG. 

09.42.57. 0 OB 

09.42.57.$REVERT.CCL 
09.42.58.DISPLAY,EF. 

09.42.58. 10 12B 

09.42.58.DISPLAY,EFG. 

09.42.58. 7 7B 


The procedure attempts to compile a BASIC program that is not an INPUT record. This 
generates error code 7 in EF but does not affect EFG while control is still within the 
procedure. When control reverts to the command record, EF returns to its original setting 
and error code 7 is set in EFG. 
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Example 4 - DSC Flag Use: 


The following commands (below on left side) demonstrate the effect of DSC=0 and DSC=1. On 
the right side is the dayfile segment resulting from processing of the preceding commands. 


SET,DSC=0. 

SKIP,LABL1. 

COMMENT. SINCE THE DAYFILE SKIP 
COMMENT. CONTROL IS SET TO ZERO. 
COIWENT. THESE STATEMENTS WILL NOT 
COMMENT. APPEAR IN THE DAYFILE. 
ENDIF,LABL1. 

SET,DSC=1. 

SKIP,LABL2. 

COMMENT. SINCE THE DAYFILE SKIP 
COMMENT. CONTROL IS NOW SET TO ONE^ 
COMMENT. THESE STATEMENTS WILL 
COIWENT. APPEAR IN THE DAYFILE AND 
COMMENT. EACH WILL BE FLAGGED 
COMMENT. WITH TWO INITIAL PERIODS. 
ENDIF,LABL2. 


16.49-36.SET,DSC=0. 

16.49.36.SKIP,LABL1. 

16.49.36. ENDIF,LABL1. 

16.49.37.SET,DSC=1. 

16.49.37.SKIP,LABL2. 

16.49.37...COMMENT. SINCE THE DAYFILE SKIP 
16.49.37...COMMENT. CONTROL IS NOW SET TO ONE, 

16.49.37.. .COMMENT. THESE STATEMENTS WILL 

16.49.37.. .COMMENT, APPEAR IN THE DAYFILE 

16.49.37.. .COMMENT. AND EACH WILL BE FLAGGED 
16.49.37...COMMENT. WITH TWO INITIAL PERIODS. 

16.49.37. ENDIF,LABL2. 


SKIP COMAAAND 

The SKIP command initiates unconditional skipping of succeeding commands. Skipping is 
terminated by an ENDIF command that has a label string matching the label string specified 
on the SKIP command. Only an ENDIF command, and not an ELSE command, terminates skipping 
initiated by a SKIP command. 

Format: 

SKIP,label. 

Parameter Description 


label Specifies a 1- to 10-character alphanumeric string. The string must 

begin with an alphabetic character. 

An example of the use of the SKIP command is given after the description of the ENDIF 
command. 
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WHILE COMMAND 


The iterative commands WHILE and ENDW bracket a group of commands into a loop that can be 
repeatedly processed. The beginning of the loop is identified by a WHILE command and the 
end by an ENDW command. The ENDW command must have a label string that matches the label 
string specified on the WHILE command. The loop is repeated as long as the expression in 
the WHILE command is true. If the expression is initially false, control immediately skips 
to the ENDW command. 

Label strings of all WHILE commands within the command record of a job should be unique. 
Duplication of a label string within a command record or within a procedure can produce 
unpredictable results. The same label string can be used in a called procedure and in the 
calling command record or procedure. 

Format: 

WHILE,expression.label. 

Parameter Description 

expression Specifies any valid symbolic name or expression described earlier 

in this section. The separator following expression must be a 
comma. 

label Specifies a 0- to 10—character alphanumeric string. The string 

must begin with an alphabetic character. 

Example: 

The following commands initiate a loop which is repeated five times. 

SET^R1=0. 

SET,R2=5. 

WHILE,R1.LT.R2,FINISH. 

SET,R1=R1+1. 

DISPLAY,R1. 


ENDW,FINISH. 

You can vary the number of repetitions by setting different values in R2. 
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JOB CONTROL COMMANDS 


7 


The job control commands alter information that controls jobs while in the system and 
retrieves information concerning the status of jobs. The commands included in this category 
are; 


BLOCK 

LISTLID 

SETASL 

CFO 

MACHINE 

SETCORE 

CHARGE 

MFL 

SETJAL 

CHVAL 

NORERUN 

SETJOB 

CLASS 

NOTE 

SETJSL 

COMMENT 

OFFSW 

SETPR 

CTIME 

ONSW 

SETTL 

DAYFILE 

PASSWOR 

SHELL 

DROP 

PAUSE 

STIME 

ENQUIRE 

PROTECT 

SUBMIT 

ENTER 

QGET 

SWITCH 

ERRMSG 

QUEUE? 

UPROC 

GO 

REDO 

USECPU 

HTIME 

RERUN 

USER 

Job 

RESOURC 


LDI 

RFL 


LENGTH 

ROLLOUT 


LIMITS 

RTIME 



You must have specific authorization to use LDI, PASSWOR, PROTECT, or SUBMIT. You can use 
the remaining commands regardless of your authorization. A listing of validation 
information can be obtained using the LIMITS command. Although you are allowed to change 
several control values for your job (with the Job, RPL, SETPR, and SETTL commands), you can 
never specify more than that for which you are validated. 

The system uses the USER command and CHARGE command for checking your authorization and 
system accounting information. The RESOURC command is used by the system to prevent 
deadlocks from occurring when several tapes or packs are used concurrently. 
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BLOCK COMMAND 


The BLOCK conmand defines one or more lines of 10 by 10 (10 lines by 10 coluxons) block 
letters to be added to a file. The large, 10-line characters provide easier identification 
of output listings. 

Format; 

BLOCK, Ifn,rewind,cc./line j/line 2 /.../lincu 

Parameter Description 

Ifn Specifies the name of the local file to receive the block character 

lines. Default is OUTPUT. 

rewind Specifies whether or not Ifn is rewound before the block character lines 
are printed. Values that can be specified for rewind are R (rewind) and 
NR (no rewind). The default is NR. 


NOTE 


If file Ifn contains data and you specify that Ifn 
is to be rewound, the block characters written to 
the file will overwrite data at the beginning of the 
file. 


Specifies the carriage control character to be inserted before the first 
line of block characters. The default value is 1 (top of form). The 
carriage control characters are described in appendix H. PM is not 
accepted. However, a space and special characters can be specified as 
literals (for example, $-$). 

Specifies the delimiting character that separates the block character 
lines. The delimiter can be any character and must be the first 
character following the command terminator. Consecutive delimiters 
generate blank lines. 

linen Specifies either a string of up to ten characters which constitute one 

line of block characters, or one of the following special values; 

Special Value Description 


DATE 

Current date. 

TIME 

Current time. 

USER 

Current user name 

UJN 

User job name. 

JSN 

Job sequence name 


I 
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Example: 


Following Is a BLOCK command and its resulting output: 

/block,bLockf.*myjob*date 
BLOCK,BLOCKF.*MYJOB*DATE 
/list,f=bLockf 
1 

1 



MM 

MM 

YY YY 

JJJJJJJJ 

00000000 

BBBBBBBBB 




MMMM MMMM TY YY 

JJJJJJJJ 

0000000000 

BBBBBBBBBB 




MM MMMM 

MM 

YY YY 

JJ 

00 

000 

BB BB 




MM MM 

MM 

YYYY 

JJ 

00 

0 00 

BB BB 




MM MM 

MM 

YY 

JJ 

00 

0 00 

BBBBBBBBB 




MM 

MM 

YY 

JJ 

00 0 

00 

BBBBBBBBB 




MM 

MM 

YY 

JJ JJ 

00 0 

00 

BB BB 




MM 

MM 

YY 

JJ JJ 

000 

00 

BB BB 




MM 

MM 

YY 

JJJJJJJ 

0000000000 

BBBBBBBBBB 




MM 

MM 

YY 

JJJJJ 

00000000 

BBBBBBBBB 



88888888 

77777777 

/ 

11 

0000 

/ 

22222222 

88888888 

8888888888 

7777777777 

// 

1111 

000000 

// 2222222222 

8888888888 

88 88 

7 

77 

// 

11 11 

00 

00 

// 

2 22 

88 88 

88 88 


77 

// 

11 

00 

00 

// 

22 

88 88 

88888888 


77 

// 

11 

00 

00 

// 

222 

88888888 

88888888 


77 

// 

11 

00 

00 

// 

222 

88888888 

88 88 


77 

// 

11 

00 

00 

// 

222 

88 88 

88 88 


77 

// 

11 

00 

00 

// 

222 

88 88 

8888888888 


77 

// 

1111111111 

000000 

// 

2222222222 

8888888888 

88888888 


77 

/ 

1111111111 

0000 

/ 

2222222222 

88888888 


0 

Column one of the listing contains printer carriage control characters 1 and 0. The 1 
character produces a form feed. The 0 characters produce double spacing. 


CFO COMMAND 

The CFO (comment from operator) command sends data to one of your executing jobs. The 
command places data in locations RA + 70B through RA + 74B of the program's field length. 
The CPU program receiving the data must set the CFO flag (bit 14 of RA + 0) to indicate it 
will accept CFO data. The CFO command clears the CFO and the PAUSE flags in RA after it 
places data in the job's field length. 

Format: 

CFO,j sn.data 

Parameter Description 

jsn The job sequence name (JSN) of the job to receive the data, 

data The data for the job. The data must be 36 characters or less. 
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CHARGE COMMAND 


The CHARGE command causes the system to record on the account dayfile all information 
regarding resources used in the previous account block, and designates a new charge and 
project number for subsequent activity. Its purpose is to control the accounting activity 
of the system for a customer or the Installation. An account block is that portion of a job 
from one CHARGE command to the end of the job or to another CHARGE command. 

Format; 

CHARGE,CN=chargenumber,PN=proj ectnumber. 
or 

CHARGE,chargenumber.proj ectnumber. 
or 

CHARGE,*. 

or 

CHARGE. 

Parameter Description 

chargenumber Specifies the charge number assigned to you by your site, 
projectnumber Specifies the project number assigned to you by your site. 

The CHARGE command has four formats: 

• If you use the first format, the parameters are order-independent. 

• If you use the second format, the parameters are order-dependent. 

• If you use the third format, the system uses your default charge and project numbers 

(refer to the LIMITS command in this section). 

• If you use the fourth format, the system reads the charge number and the project 
number from a record of file INPUT. This record must be a single line with the 
following format: 

chargenumber,projectnumber 

If your job is an interactive job, the system prompts you to enter your charge and project 
numbers. 

The CHARGE command is used in the control of user accounting. The project master user can 
Impose limits on the SRUs your jobs may accumulate under that project number, restrict your 
access to the system to a certain time of the day, and, in general, monitor your use of the 
system. 

If the specified charge and project numbers have a project prologue associated with them, 
the project prologue is executed each time the charge number is entered on a CHARGE 
command. A CHARGE command entered as the first command in the job also causes the system 
and user prologues, if any, to be executed. The system prologue is executed first, followed 
by the project and user prologues. For a CHARGE command other than the first CHARGE command 
in the job, only the project prologue is executed. 

If you use a second or subsequent CHARGE command in a job and if the current active charge 
and project numbers have a project epilogue associated with them, that project epilogue is 
executed, followed by the specified CHARGE command and then by the project prologue (if any) 
for the new charge and project numbers. 
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If your site requires that you use a CHARGE comnand , the system automatically uses your 
default charge and project numbers when necessary. For interactive jobs, the system uses 
your default charge and project numbers each time you log in. If your default charge and 
project numbers are not defined or are not valid, the system prompts you for valid charge 
and project numbers. For batch jobs, the system uses your default charge and project 
numbers if you do not include a CHARGE command immediately following the USER command. If 
you do include a CHARGE command following the USER command, the system uses the charge 
number you supply. 

The CHARGE command sets the SRU limits for the account block and the job step to the user 
name validation limits or the account validation limits, whichever is smaller. Refer to the 
SEXJSL and SETASL commands later in this section. 

In addition to supplying charge and project numbers at job initiation, you may also be 
required to supply charge and project numbers under certain other conditions. Specifically, 
you may be required to enter additional charge and project numbers as a result of an SRU 
limits exceeded condition or as a result of a project prologue. 

If you are assigned more than one charge or project number, you can include additional 
CHARGE commands in your job to record resources used under each charge number~project number 
combination. Whenever a new CHARGE command is issued, the SRU information for the previous 
charge number and project number is written to an accoxmt dayfile and then cleared. 

However, the other accumulators (central processor time, mass storage activity, and so on) 
are not cleared but continue to increment. 

For a complete list of accounting messages issued to the job's dayfile, refer to Job 
Completion in section 3. 


CHVAL COMMAND 


The CHVAL command redefines your validation limits or privileges. Currently, you are only 
allowed to redefine your default service class assignments. 

Format: 


CHVAL,UC=otsc. 


Parameter 


Des.c.ription 


UC=otsc 


Specifies the default service class assignment according to origin 
type. The value otsc is the desired service class mnemonic appended to 
the mnemonic for the origin type. Do not place a separator between the 


mnemonics. 

The value ot must be one of the following: 

ot 

Description 

BC 

Local batch 

lA 

Interactive origin 

RB 

Remote batch 

The value 

sc must be one of the following: 

sc 

Description 

BC 

Local batch 

CT 

Communication task 

DI 

Detached interactive 
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Parameter 


Description 


sc Description 

MA Maintenance 

NS Network supervisor 

RB Remote batch 

SY System 

TS Interactive 

In Installation class n (0 _< n ^ 3) 

You must be authorized to use the service class you select. The LIMITS 

command shows the service classes you are allowed to use and your 
default service class assignments. 


Example: 

In the following example, the default service class assignment for interactive jobs is 
changed from interactive (TS) to detached interactive (DI). 

/Limits 


THE FOLLOWING ARE ALLOWED SERVICE CLASSES - 
BATCH (BC) 

REMOTE BATCH (RB) 

INTERACTIVE (TS) 

DETACHED INTERACTIVE CDI) 

THE USER DEFAULT SERVICE CLASS 


FOR BATCH ORIGIN IS.BC 

FOR REMOTE BATCH ORIGIN IS.RB 

FOR INTERACTIVE ORIGIN IS.TS 

INQUIRY COMPLETE. 

/chvaL,uc=iadi 
UPDATE COMPLETE. 

/Limits 


THE FOLLOWING ARE ALLOWED SERVICE CLASSES - 
BATCH (BC) 

REMOTE BATCH (RB) 

INTERACTIVE (TS) 

DETACHED INTERACTIVE (DI) 

THE USER DEFAULT SERVICE CLASS 


FOR BATCH ORIGIN IS.BC 

FOR REMOTE BATCH ORIGIN IS.RB 

FOR INTERACTIVE ORIGIN IS.DI 

INQUIRY COMPLETE. 
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CLASS COMMAND 


The CLASS conmand changes the service class of your current interactive job or of a batch 
job you have submitted for execution. For interactive jobs, the CLASS command can only 
change the service class of the interactive job from which it was entered; it cannot change 
an interactive job connected to another terminal. For batch jobs, you can change the 
service class of any executing job or any job in the input queue. This includes the job 
from which the CLASS command was entered. 

The CLASS command also shows the relative priority of the available service classes for a 
specified origin type. Implicitly, the relative priority display also shows which service 
classes are allowed within the chosen origin type. 

Format; 

CLASS,SC=sc,OP=A. 
or 

CLASS,sc,, ,A. 
or 

CLASS,OT=ot,L=lfn. 
or 

CLASS,,ot,Ifn. 
or 

CLASS,SC»sc,JSN=jsn. 
or 

CLASS,sc,,,,jsn. 

The parameters are order-independent if you specify them in the keyword=value form. 
Otherwise, they are order-dependent. 

Parameter Description 

SC=sc Specifies the desired service class for the job. The value sc must be 

one of the following; 

sc Description 

SY System 

BC Local batch 

RB Remote batch 

TS Interactive 
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Parameter 


Description 


OP=A 


OT=ot 


L=lfn 


JSN=jsn 


sc 

Description 


DI 

Detached interactive 


NS 

Network supervisor 


HA 

Maintenance 


CT 

Communication task 


In 

Installation class n (0^n^3) 


There is no default for this parameter. The service 
must be within your validation limits (refer to the 

class you specify 
LIMITS command). 

Selects the abort option. The command aborts if too many jobs in the 
system already have the service class you specified. Otherwise, if this 
situation occurs, the system rolls out your job and waits until it can 
make the desired assignment. 

Specifies the origin type for which the system shows the relative 
priority of the available service classes. The value ot can be any of 
the following: 

ot 

Description 


SY 

System origin 


lA 

Interactive origin 


BC 

Local batch origin 


RB 

Remote batch origin 



The default is the origin type of the current job. If you specify OT=ot 
along with SC=sc, OT=ot is ignored. 

Specifies the file that receives the display generated by this command. 
OUTPUT is the default. If you specify L=lfn along with SC=sc, L=lfn is 
ignored. 

Specifies the JSN of an executing job or a job in the input queue. 


The first and second formats change the service class of your current job. If you use the 
first or second format and do not specify a valid service class (for instance, you omit that 
value), the system displays the relative priority of the service classes available for your 
job. Further, if your job is interactive, you receive a prompt for a service class. 


The third and fourth formats generate a display of the relative priority of the available 
service classes for a designated origin type. 

The fifth and sixth formats change the seirvice class of an executing batch job or of a job 
in the input queue. They cannot be used to change the service class of an interactive job. 
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Example: 


The following terminal session shows how you can ascertain the relative priority of the 
service classes for your current job. 

/class 

AVAILABLE SERVICE CLASSES 


-RELATIVE PRIORITY- 


CLASS 

INPUT FILES 

EXECUTING JOBS 

OUTPUT FILES 

DI 

★ 

****** 

*********** 

10 

* 

******* 

*********** 

TS 

*********** 

************ 

*********** 

ENTER 

CLASS: di 



CLASS 

COMPLETE. 




CURRENT 


COMMENT COMMAND 

The COMMENT command allows you to place a comment in the system dayfile and the dayfile of 
any of your jobs. 

Format: 

COMMENT,j sn.comment 
or 

COMMENT.comment 
or 

*coinment 

Parameter Description 

jsn Specifies the job sequence name (JSN) of the job in whose dayfile you 

want the comment written. The default is the current job. 

comment Specifies the message you want written in the designated dayflles. 

If you use the third format of the command, the asterisk must be the first nonblank 
character of the command. 
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CTIME COMMAND 


The CTIME command requests that the accumulated CPU time for the job be Issued to the job's 
dayflle (In seconds). 

Format: 

CTIME. 

DAYHLE COMMAND 

The DAYFILE command causes the system to write the job's dayflle to the file specified. 

For printed DAYFILE output, you can specify output page size and print density using the PL 
and PD parameters. The DAYFILE command also honors the page length and print density set 
for your job using the SET command and the PL and PD s 3 rmbollc names. 

Format: 

DAYFILE,L=lfn,FR=s tring,OP=op,PD=pd,PL=pl,I=infile. 
or 

DAYFILE,Ifn,string,op,pd,pi,infile. 

Parameter Description 

L=lfn Specifies the file on which the dayfile is to be written. If L=lfn is 

omitted, OUTPUT is assumed. Pagination will occur if listing file name 
is OUTPUT or if the PD or PL parameters are specified. 

FR“string Specifies a character string for which a search is to be made in the 
dayfile. The op parameter specifies the field to be searched. 

The string specified must begin with the first character in the field to 
be searched. The time field begins with a blank. 

If the string contains characters other than letters and numbers (such 
as blanks), it must be enclosed by $ delimiters. A $ within the string 
must be entered twice ($$) so it is not interpreted as a delimiter. 
Interactive commands entered in the dayfile are preceded by a $ unless 
.you were under the batch subsystem when you issued the command. To 
search for a interactive command, the $ preceding the command is 
replaced with two $'s, and the command is enclosed by $ delimiters (for 
example, $$$OLD$). 

If the string is found, the portion of the dayfile following the last 
occurrence of the specified string is output. If the string is not 
found, an informative message and the entire dayfile is output for jobs 
where the output file is connected to a terminal; where the output file 
is not connected to the terminal, the job receives only the informative 
message. 
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Parameter 


Description 


OP=op 


PD=pd 


PL=pl 


I=infile 


Selects search option (single character): 

°P Description 

T Search time field for string specified by FR=string. 

M Search message field for string specified by FR=string. 

I Incremental dump (dayfile printed from point of last dayfile 

command). 

F Full dump. 

If a literal string (string) is specified and op is omitted, OP=M is 
assumed. If both string and op are omitted, OP=F is assumed unless the 
output file is connected to a terminal. In this case, OP=I is assumed. 

Specifies the print density; default is PD=6. 

pd Print Density 

3 Double space; 6 lines per inch 

4 Double space; 8 lines per inch 

6 Single space; 6 lines per inch 

8 Single space; 8 lines per inch 

Specifies page size; if specified, the actual page size used is 
determined by page density (pd) and the value specified for pi, as 
follows: 

pd Page Size 

3 pi / 2 

4 pi / 2 

6 pi 

8 pi 

If this parameter is omitted, page size is determined from system page 
size and print density as follows: 

pd Default Page Size 

3 30 lines 

4 30 lines 

6 60 lines 

8 60 lines 


Specifies a file which contains a dayfile to be used for input. If 
I=infile is omitted, the DAYFILE command uses the active dayfile for 
input. 


NOTE 


A paginated dayfile listing cannot be used 
as the input file (I=infile). Refer to 
L*lfn parameter. 
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Examples: 


DAYFILE,,$ 11.21.$,T. 

The dayfile is dunped to OUTPUT starting at the last occurrence of 11.21. in the 
time field. 

DAYFILE,1=DAY,FR=$$ $GET,STATS.$ 

The dayfile is dumped to OUTPUT starting at the last occurrence of $GET,STATS, in 
the message field of the previously written dayfile named DAY. 

The system may place diagnostic messages in the output produced by DAYFILE. They are not 
part of the job's dayfile from which the DAYFILE output is produced. These messages begin 
with NOTICE*** and are described in appendix B. 
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DROP COMMAND 


The DROP conanand drops executing jobs or queued files. You can drop only jobs or queued 
files belonging to you. You cannot drop the job from which you enter the DROP command. 

A job or queued file belongs to you if it is your current job, was created by your current 
job, or was created by another job belonging to you. Thus, any job you submit from your 
current job belongs to you, even if the USER command in the submitted job has a user name 
different from the user name you specified when you logged in (or different from that of the 
first USER command if the current job is a batch job). 

Format; 


DROP,JSN=j sn,DC=q,UJN=uj n,OP=R. 
or 

DROP,j sn,q,uj n,R. 

The parameters are order-independent if you specify the parameters in the keyword=value 
form. Otherwise, they are order-dependent. 

Parameter Description 


JSN-jsn Specifies the job sequence name (JSN) of the job to be dropped. 

UJN=ujn Specifies the user job name (UJN) of the job to be dropped. You can 

specify the JSN, the UJN, or both. 

DC=q Specifies the disposition of the job to be dropped. You must specify q 

if neither the JSN nor the UJN is specified. In this case, the system 
drops all of your jobs with the specified disposition. If JSN or UJN is 
specified, the default for q is ALL. 


OP=R 


Examples: 


q Description 

WT Jobs queued with a wait disposition. 

PR Jobs queued for printing. 

PU Jobs queued for punching. 

PL Jobs queued for plotting. 

IN Jobs queued for input. 

EX Executing jobs. 

ALL All jobs belonging to you. 


Directs the system to drop the specified executing jobs without EXIT 
processing but with single—reprieve processing for jobs containing such. 


DROP,ABDA. 

DROP,,PR. 

DROP. 

DROP,JSN-ABFF,OP=R. 


Drops executing job ABDA. 

Drops all of your jobs queued for printing. 

Incorrect. You must specify a JSN, UJN, or the DC=q parameter. 

Drops executing job ABFF with a single reprieve and without EXIT 
processing. 
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ENQUIRE COMMAND 


The ENQUIRE cosmand gives you Information about your jobs In the system. For output listing 
flies not connected to your terminal, the ENQUIRE command honors the page length and print 
density set for your job using the SET command and the PL and PD symbolic names. 

Format: 

ENQUIRE,OP=piP2...Pn, FN=lfn^,0=lfn2. 
or 

ENQUIRE,pjP2.. .pjj. 
or 

ENQUIRE,JSN=jsn,0=lfn2. 


or 


ENQUIRE,UJN=ujn,0=lfn2. 
or 

ENQUIRE. 

Parameter Description 


OP=pjp 2 ...p 7 Any combination of the following options. You can request a maxi¬ 
mum of seven options on a command (for example, ENQUIRE,OP=BDFJLRS.). 

Pi Description 

A Gives listings of the B, D, R, U, J, L, and F options. 

If you specify no parameters or only the 0=lfn2 
parameter In a batch job, the 0P=PlP2»««Pn 
parameter defaults to OP=A. 

B Returns Identification and priority information. On a 

secured system, the system also lists the current job 
access level, the upper limit for the job access level, 
the lower limit for the job access level, and the 
security access categories you can assign to permanent 
files. 
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Parameter 


Description 


Pi 


Example: 


Description 


/enquire,b 
SYSTEM ACTIVITY. 


USER NAME 

STARSKY 

USER INDEX HASH 

AN2A 

JOB SEQ. NAME 

ABLE 

FAMILY 

NOSHOP 

CHARGE NUMBER 

2222 

PROJECT NUMBER 

666N666 

PACK NAME 

★NONE*. 

PACK TYPE 

Dll 

PRIMARY FILE 

★NONE*. 

SUBSYSTEM 

BATCH. 

CPU PRIORITY 

30 

MAX FL (CM) 

203700 

MAX FL (EM) 

0 

LAST FL (CM) 

0 

LAST FL (EM) 

0 


D Returns a listing of the resources you have demanded and 

those which have been assigned (refer to RESOURC Command 
in this section 6). 


Example: 


RESOURCE DEMAND INFORMATION. 


RESOURCE 

DEMAND 

ASSIGNED 

PE 

1 

0 

HD 

1 

0 
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Parameter 


Description 


Pi Description 


F Gives the status of files assigned to your job. 

Example: 

/enquire,f 


LOCAL FILE 

INFORMATION. 




FILENAME 

LENGTH/PRUS 

TYPE 

STATUS 

FS LEVEL 

INPUT 


TT. 



INPUT* 

1 

IN.* 

EOR 


LIBRT 

6429 

PM.* 

*INACCESS* NAD 

OUTPUT 


TT. 



PROFILE 

6 

LO. 

EOR 

NAD 

PROCFIL 

3 

LO. 

EOI 


PROLOG 

1 

LO. 

EOR 

NAD 

PUBTOOL 

835 

PM.* 

EOR 

NAD 

2ZZZZLD 

5 

LO. 

EOR 

NAD 

TOTAL = 9 





An asterisk 

(*) after the file 

type indicates that 


the file is locked. (You cannot write on a locked 
file.) Refer to the FILE function in section 6 for 
the meaning of the file type mnemonics. For 
magnetic tape files (TYPE=TP), the current position 
block number is displayed in the LENGTH/PRUS column 
instead of the file length. The Status column 
indicates the current position of the file (I/C 
Indicates mid- record) and whether the last 
operation performed was a write. The entry 
*1NACCESS* indicates that the file is inaccessible; 
it resides on a mass storage device that is 
currently off or down. The FS column indicates 
whether a file has the no-auto-drop status (refer to 
the SETFS command). The LEVEL column gives the 
security access level of the file. 

On an unsecured system, the security access level is 
listed only if it is not null. 
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Parameter 


Description 


Pi Description 

J Returns the contents of your control registers, error flag 
field, and succeeding cosmands. 

If the J option is used within a procedure, only the next 
commands in the procedure are listed. 

Example: 

JOB CONTROL REGISTERS. 

R1 = 0 

R2 = 0 

R3 = 0 

EF = 0 

EFG = 0 

RIG = 0 

JOB PAGE PARAMETERS. 

PW = 136 

PL = 60 

PO = 6 

PENDING COMMANDS 

WHILE,R1<20,COPY. 

C0PYEI,AGENDA. 

REWIND,A6ENDA. 

SET,R1*R1+1. 

ENDW,C0PY. 

REWIND,ENQWAJ. 

COPYSBF,ENQWAJ. 

REPLACE,ENQWAJ. 

L Returns your loader information including the status of 

CYBER Interactive Debug utility (refer to the CYBER Loader 
Reference Manual). 

Exaiiq>le: 

LOADER INFORMATION. 

MAP OPTIONS = DEFAULT 
DEBUG = OFF 

GLOBAL LIBRARY SET IS - 

LIB 3 
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Parameter 


Zl 

R 


Description 


Description 


Returns your amount of resources used. The resources 
listed include CPU time, mass storage activity, magnetic 
tape activity, permanent file activity, and adder 
activity. These statistics are factors used in 
calculating SRUs used. 

Example: 

RESOURCES USED. 


CPU TIME 

0.107 

SECS. 

MS ACTIVITY 

0.914 

KUNS. 

MT ACTIVITY 

0.000 

KUNS. 

PF ACTIVITY 

0.034 

KUNS. 

ADDER 

0.003 

KUNS. 

SRU 

3.157 

UNTS. 
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Parameter 


Description 


Pi 

S 


T 


U 


Description 


Returns your accumulated SRUs. The SRU represents your 
total usage of the system. This unit is derived from 
central processor time, I/O activity, adder activity, 
and memory usage. 

Example: 

SRU ACCUMULATOR. 

SRU 3.162 UNTS. 

Returns accumulated CPU time. 

Example: 

CPU ACCUMULATOR. 

CPU TIME 0.111 SECS. 

Returns the initial amount of resources available to you 
in seconds, job step SRU, account block SRU, and the 
remaining resources available for dayfile messages, com¬ 
mands, and mass storage. These values apply to the 
current job and were set at the beginning of the job by 
default or by the SETJSL, SETASL, or SETTL commands. As 
the job progresses, the system increments the 
appropriate resource counters. Secondary USER commands 
do not affect these values. Entering a different CHARGE 
command affects your account block and job step SRU 
limits (refer to the CHARGE command). 

Example: 

RESOURCE USAGE ALLOWED. 


SECONDS 64 

JOB STEP SRU 31808 

ACCOUNT BLK SRU 31808 

DAYFILE MESSAGES 993 

COMMANDS NO LIMIT 

MASS STORAGE 59008 
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Parameter 


Description 


UJN=ujn 


Returns a one-line report of each of your jobs with the specified user 
job name (OJN). The report for each job has the following fields; 

jsn sc cs ds lid ujn status executing message 

The fields have the following descriptions: 

field Description 

jsn The job sequence name (JSN). It is a four-character, 

system-defined name. 

sc The service class of the job. One of the following 

mnemonics appears in this field: 

sc Service Class 

S System 

B Batch 

R Remote batch 

T Interactive 

D Detached interactive 

N Network supervisor 

C Communication task 

M Maintenance 

0 Installation class 0 

1 Installation class 1 

2 Installation class 2 

3 Installation class 3 

cs The connection status (CS) of your job; that is, whether 

your job is online and interactive, detached and 
interactive, not interactive or queued. The following 
values can appear: 


cs 

Description 

ON 

Online and interactive 

DT 

Detached and interactive 

NI 

Not interactive 

blank 

Queued 
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Parameter 


Description 


Description 

ds The default destination of batch output. It 

indicates whether batch output will be routed to the 
central site (BC) or to a remote batch terminal (RB). 

lid The logical identifier (LID) of the mainframe that 

is to process the job. This is a three-character, 
site-defined mnemonic. 

ujn The user job name (UJN) of the job. It is either 

the name you assigned the job or it is your user 
index hash if you did not assign the job a name. 

status The overall job status. It Indicates whether the 

job is executing, whether it has been rolled out, or 
the queue in which it now resides. If the job is 
suspended, the number of minutes remaining until 
timeout is displayed along with the status indicator. 

executing The command that the system is now executing. 

message 

Example: 

/enquire,uj n=ldij ob 

JSN SC CS DS LID UJN STATUS EXECUTING MESSAGE 

ABCF.B. .BC. .LDIJOB WAIT QUEUE 

If you specify only the keyword UJN, the system returns a one-line 
report for each job associated with your user name. 

Example: 

/enquire,ujn 

JSN SC CS DS LID UJN STATUS EXECUTING MESSAGE 

ABCH. B. .BC.M42.LEVEL INPUT QUEUE 

ABCB.T.ON.BC. .AJLA EXECUTING 

ABCI. B. .BC.M42.LDIJOB PRINT QUEUE 

ABCF.B. .BC. .LDIJOB WAIT QUEUE 

Do not specify the UJN=ujn parameter with any parameter other than 

0=lfn2. 

JSN“jsn Returns a detailed report of the job with the specified job sequence 

name (JSN). The format of the report varies with the status of the 
job. If the job is executing, the report includes the JSN, the 
job's service class, its connection status, the default destination 
of its batch output, the current status of the job, the user job 
name (UJN), the job access level (on a secured system only), job 
resource information, the executing command, a dayfile extract 
(maximum of 10 messages), and a list of the next commands to be 
executed (maximum of 10 commands). 
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Parameter 


Description 


Example: 

/enquire,j sn=abcb 

LEVEL=LVLO 
ECS FL= 0. 


ABCB.T.ON.BC. .EXECUTING UJN=AJLA 

SRUS= 2.573. SRU LlHrT=N0 LIMIT. CM FL= 5000. 


DAYFILE = 

17.26.55. SUBMIT COMPLETE. JSN IS ABCE. 
17.27.07.GET,OPLJOB. 

17.2 7. 21. RE PL AC E, C ATE 60R. 

17.27.32. SUBM IT , OPL JOB,TO. 

17.27.32. SUBMIT COMPLETE. JSN IS ABCF. 
17.28.04. ROUT E , CATE GOR , DC =I N. 

17.28.04. ROUTE COMPLETE. JSN IS ABCH. 

17.28.13.ENQUIRE,UJN. 

17.28.26. ENQUIRE,JSN. 

17,29.04.ENQUIRE,JSN=ABCB. 


If the job is a queued file, the report includes the job's JSN, its 
service class, the default destination of its batch output, the 
logical identifier (LID) of the mainframe that is to process the job, 
its queue residence, its UJN, length in PRUs, and output 
specifications. 

Example: 

/enqui re, j srF=abcf 

ABCF.B. .BC. .WAIT QUEUE UJN*LDIJ0B LEVEL=LVLO 

PRU LENGTH* 32. DC=TT. FC= . ID= 0. EC= 

If you specify the keyword JSN, the system returns a one-line report 
on each job associated with your user name. The fields in the display 
are identical to those you get when you specify only the keyword UJN, 
except that the UJN field and the EXECUTING MESSAGE fields are omitted. 

Example: 


FN=lfni 

0=1fn2 


/enquire,jsn 

JSN SC CS DS LID STATUS JSN SC CS DS LID STATUS 

ABCH. B. .BC.M42.INPUT QUEUE ABCB.T.ON.BC. .EXECUTING 

ABCI. B. .BC.M42.PRINT QUEUE ABCF.B. .BC. .WAIT QUEUE 

3 

Do not specify the JSN=jsn parameter with any parameter other than 
0=lfn2. 

Returns the status of local file Ifni (refer to the 0P=F parameter). 

Writes the output on file lfn2. The default is OUTPUT. If you 
specify only the 0 =lfn 2 parameter in a batch job, the 
0P=PlP2...pn parameter defaults to 0P=A. 
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If you enter the ENQUIRE command with no parameters from an interactive job, the system 
gives a two-line report of the current job. 

Example: 

/enquire 

JSN: AAFA SYSTEM: BATCH SRU: 2.055 FILE NAME: SAMPOUT 

STATUS: IDLE 

It always returns the status IDLE. To get a report on the current job while the system is 
executing another command, enter-the ctE or ctS command (refer to Interactive Status 
Commands in section 8). 

If you enter the ENQUIRE command with no parameters in a batch job, the command defaults to 
ENQUIRE,OI>-A. 


ENTER COMMAND 


The ENTER command enters a series of commands on one line. This is especially usefiil for 
interactive users operating in the batch subsystem. 

Format: 


ENTER./command j/command2/.•./commandn 

/ Delimiting character used to separate the individual commands on one 

line. It can be any character not used within the commands and must 
immediately follow a period or right parenthesis. 

commandAny NOS command you are authorized to use. Interactive commands for 
which there are no batch counterparts are not acceptable. 

The system supplies a terminator (period or right parenthesis) if it is missing from any 
command. 

Example: 

From a terminal, you enter the batch subsystem and type in an ENTER command on one line as 
follows; 

batch 

RFL,0. 

/enter.#get,fprog#ftn5,i=fprog#map,part#1go#exit#drap#rewind,zzzdump#copy,z2zdump 

This is the sequence of commands used in section 14 to Illustrate the reading of CM dumps. 
Assuming that a FORTRAN 5 program is on the indirect access file FPROG, output like that 
shown in the figures in section 14 is produced when this command is processed. 
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ERRMSG COMMAND 


The ERBMSG command controls the display of error messages generated by commands executed 
within a NOS procedure. An ERKMSG,OFF command inhibits the display of error messages at the 
terminal, although all messages are still listed in the dayfile. This command has no effect 
when issued from a batch job. 

The ERSMSG command must be executed from within a procedure. The error message off status 
remains in effect until an ERSMSG,ON command is issued, or until your job returns to 
interactive command status. The error message off status is not affected by the entry of 
subsequent BEGIN or REVERT commands (that is, nested procedures). 

Format: 

ERRMSG,status 

Parameter 


status 


GO COMMAND 

The GO command clears the pause bit of one of your executing jobs. The system may have set 
the pause bit because of an error or a request for user input. You can set the pause bit 
with one of your programs or with the PAUSE command. 

Format: 

GO,jsn. 

jsn Specifies the job sequence name (JSN) of the job whose pause bit you 

want to clear. 

You must check the status of the pause bit to effectively use this command. The program does 
not pause just because the pause bit is set. Similarly, the program does not proceed just 
because the pause bit has been cleared. You can write a program that checks the status of 
the pause bit and waits for that bit to be cleared (refer to the RECALL macro in Volume 4, 
Program Interface). 

If you want to determine whether a PAUSE or GO command has been entered, write a program to 
set bit 13 of word RA and then status it. The system unconditionally clears bit 13 of word 
RA whenever the PAUSE/GO command sets/clears the pause flag (bit 12 of word RA). Hence, 
when the system clears it, you can check the pause flag. CPU programs that check the pause 
flag on NOS 1 continue to work properly on NOS 2, but these programs cannot determine when a 
PAUSE or GO command has been entered. 


Description 

Specifies whether error messages generated by commands within a 
procedure are displayed at the terminal. Values that can be specified 
for status are OFF (messages are not displayed) and ON (messages are 
displayed). The default value is ON. 
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HTIME COMMAND 


The HTIME command issues a dayfile message giving the model 176 accumulated clock cycle 
count for the job. A clock cycle on the model 176 is 27.5 nanoseconds. COMPASS 
instructions require a certain number of clock cycles to execute as described in the COMPASS 
Reference Manual. This command can be used for performance comparisons. 

Format: 

HTIME. 

The resulting dayfile message has the following format. The cycle count is in kilocycle 
units. 

HTIME nnnnnnnnnnnn.nnn KCYCLES. 

An HTIME command processed on a machine other than the model 176 produces the following 
dayfile message. 

HTIME NOT AVAILABLE. 
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JOB COMMAND 


The Job command, also known as the job card, specifies the user job name (UJN) and may 
specify job processing parameters. Refer to Job Names in section 3 for the significance of 
the user job name. The first command of a batch job must be a Job command. 

Format: 

uj n,P=priority,T=timelimit, CM=memory,EC=xmemory,ST=lid,AL=level.punchmode 
or 

uj n,Ppriority,Ttimelimit,CMmemory,ECxmemory, STlid,ALlevel.punchmode 
or 

uj n,SC=class,T=timelimit,CM=memory,EC =xmemory, ST=lid,AL=level.punchmode 
or 

ujn,SCclass,Ttimelimit,CMmemory,ECxmemory,STlid,ALlevel.punchmode 
or 

ujn,priority,timelimit,memory,xmemory,lid,level.punchmode 
or 

ujn,clas s,timelimit,memory,xmemory,lid,level.punchmode 

All parameters except the parameter ujn are optional. If you include keywords when you 
specify optional parameters, they are order-independent. Otherwise, they are 
order-dependent. 

Parameter 

ujn 

P=priority 


SC=class 


Description 

Alphanumeric user job name (UJN) of one to seven characters. This 
name identifies the Individual jobs being run under the same user 
name. 

Specifies the priority level at which the job enters the system. 
Using this priority level, the system assigns the job a service 
class according to a site-defined algorithm. The value you specify 
must be an integer in the range of 0 through 7. The default for 
P=priority depends on your default service class assignments and 
your site-defined algorithm for mapping priority levels and service 
classes (refer to Job Service Classes in section 3). 

To assign a service class to your job directly, use the SC=class 
parameter. 

Specifies the service class to be assigned to the job. The value 
class must be one of the following values: 

class Description 

SY System 
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Parameter 


Description 


class Description 

BC Local batch 

RB Remote batch 

TS Interactive 

DI Detached interactive 

NS Network supervisor 

SS Subsystem 

MA Maintenance 

CT Communication task 

In Installation-defined class n (0 n ^ 3) 

The default for SC=class depends on your default service class 
assignments (refer to Job Service Classes in section 3). 

AL=level Specifies the maximum security access level your job can attain. 

Unless changed by your site, the value level can be any one of the 
following names: 

LVLO, LVLl, LVL2, LVL3, LVL4, LVL5, LVL6, or LVL7 

You may not be authorized to use all of these access levels (refer 
to the LIMITS command). The default is the lowest access level you 
are authorized to use. On an unsecured system, this parameter has 
no effect, but the system does ensure that you specify a valid level 
name. 

T=timelimit Specifies the central processor job step time limit in seconds. 

Values can range from 1 to 99999. Decimal is the default base. 

Octal values from 1 to 77777g (1 to 32767) can be entered if 
followed by a B suffix. The default limit is 64 (lOOg).t Decimal 
values from 32767 to 99999, or values that are greater than your 
validated time limit, set the time limit at its maximum. The time 
limit set by this parameter must be sufficient for completion of 
each of the steps in the job (refer to Time Limit Control in section 
3). 

CM=memory Specifies the maximum octal field length for the job (refer to Field 

Length Control in section 3). The system rounds the value to the 
next highest multiple of lOOg. The default value is the maximum 
field length for which you are authorized (refer to the LIMITS 
command) or the maximum field length available for user jobs 
(dependent on machine size), whichever is smaller. The field length 
cannot exceed 376500g. This is the absolute upper limit; however, 
your site may choose a lower limit. 


tYour site can change this default. 
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Parameter 


Description 


A value containing an 8 or 9 or the suffix D is interpreted as 
decimal. 

EC“xmemory Specifies the maximum octal number of lOOOg, 2000g, or 4000o 

word extended memory blocks required by the job. The extended 
memory block size is site dependent; the default block size is 
lOOOg words."h This extended memory field length cannot exceed the 
amount of user extended memory allowed by the installation (refer to 
the LIMITS command). Your job must request the extended memory 
(refer to the RFL command in section 7) before it can be used. A 
value containing an 8 or 9 or the suffix D is interpreted as decimal. 

ST=lid Specifies the logical identifier (LID) of the host to which you are 

routing the specified job. The LID must be a three-character 
alphanumeric string defined by site personnel. The local host is 
the default. 

You must have special authorization to use this parameter (refer to 
the LIMITS command). 

punchmode Specifies the conversion mode for card decks. This parameter must 

be entered in columns 79 and 80. A 26 indicates that coded cards 
are to be converted in 026 mode; 29 indicates cards are converted in 
029 mode. This initial keypunch mode can be changed within the job 
by a conversion change card (refer to Coded Cards in appendix F) 
when reading cards or a ROUTE command when punching cards. If this 
parameter is omitted, the installation default keypunch mode is 
used. This conversion mode indicator is ineffective for remote 
batch jobs entered with mode 4 card readers; it is effective for 
remote batch jobs entered with HASP, 2780, and 3780 card readers. 

The system issues error messages when parameter specifications exceed validation limits. It 
also Issues an error message if an extended memory field length is specified when your 
central memory validation limit is less than lOOOOg words. Consult installation personnel 
for further installation restrictions based on the machine configuration and subsystems used. 

Example: 

JOBAAA,,1,50000,20. 
has the same effect as: 

JOBAAA,CM=50000,EC=20,T=1. 


tRefer to the UEBS parameter in common deck PPCOM under Installation Parameters in the 
HOS 2 Installation Handbook. 
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LDI COMMAND 

The LDI routine queues one or more jobs for input and optionally enters the job sequence 
name (JSN) of each job in the dayfile of the job that entered the LDI command. LDI 
initiates a new job each time it encounters an EOF. LDI starts processing at the current 
position of the file and continues until an EOI, double EOF, or EOF followed by an empty 
record is encountered. The jobs submitted are batch origin type jobs. LDI does no 
reformatting of the job file. Therefore, SUBMIT directives (/JOB,/DSER,/NOSEQ, and so 
forth) are not allowed. 

Format: 


LDI, FN=lf n, ID=id, OP=OP, DC=dc ,DN=un ,FM=f m. 


or 


LDI,lfn,id,OP,dc,un,fm. 


The parameters in the first format are order-independent. Those in the second format are 
order-dependent. 


Parameter 


Description 


FN=lfn 


Specifies the name of the file containing the job(s) to be submitted. 
LOAD is the default. 


ID=ld 


0P=0P 

DC=dc 


DN=un 


Specifies the identifier of the local device which will receive job 
output. The identifier id must be octal and in the range 0 through 
67B. If you omit this parameter or specify only the keyword ID, 
implicit central site routing occurs (refer to Implicit Routing under 
the description of the ROUTE command, section 9). 

You may not specify lD=id parameter if you specify the DN=un or FM=fm 
parameter. 

Directs the system to enter the job sequence name (JSN) of each job in 
the dayfile of the job that Issued the LDI command. 

Specifies the disposition of output for each job that is queued for 
input. 

dc Description 

IN Disposes of job output according to the default option for 

the job's origin type (refer to Job Origin Types and Service 
Classes in section 3). 

NO Discards all output. 

, TO Queues the output with a wait disposition. 

Specifies the user name of the remote batch user to whom the system 
routes each job's output. If you omit this parameter or specify only 
the keyword UN, implicit remote routing occurs (refer to Implicit 
Routing under the description of the ROUTE command, section 9). 

You may not specify this parameter if you specify the ID=id parameter. 
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Parameter 


Description 


FM=fm Specifies the family name of the remote batch user to whom the system 

routes each job's output. You must have special authorization to 
specify an alternate family name (refer to the LIMITS command). If 
you omit this parameter or specify only the keyword FM, implicit 
remote routing occurs (refer to Implicit Routing under the description 
of the ROUTE command, -section 9). 

You may not specify this parameter if you specify the ID=id parameter. 

The number of executing jobs and output files you have within the system cannot exceed your 
deferred batch job validation limit (refer to the LIMITS command in this section). If this 
limit is reached, no further jobs can be loaded until an existing job completes. 

If any of the submitted jobs contain an invalid USER command, the job entering the LDI 
command is aborted with no exit processing. If you entered the command interactively, you 
are immediately logged off with no dayfile message. The security count for the user namp 
that entered the LDI command is decremented accordingly. 


LENGTH COMMAND 

The LENGTH command gives you the current status of one of your local files. 

Format; 

LENGTH,Ifn. 

Parameter Description 

Ifn Name of a file assigned to the job. 

The information given for the local file includes its length in PRUs, type, and current 
status. The same information can be obtained with the ENQUIRE command. 
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UMITS COMMAND 


The LIMITS command directs the system to list your validation limits. The LIMITS command 
always lists the validation limits associated with the job's current user name. However, if 
a job contains more than one USER command, the actual limits associated with the job are a 
combination of the limits of the first user name and those of the current user name. You 
can use the ENQDIRE(OP=U) command to determine what your actual limits would be in such a 
case. 

Format: 

LIMITS,L=lfn. 

Parameter Description 

L=lfn Specifies the file which receives the validation information. The 

default is OUTPUT. 

The validation limits show the extent to which you can use various system resources. The 
LIMITS output falls into the following categories: 

• Resource Limits. 

• Other Characteristics. 

• User Permissions. 

• Network Applications. 

• Privileged Network Applications. 

• Local Applications. 

• Shell Permissions. 

• Security Permissions. 

• Security Access Categories. 

• Security Access Levels. 

• Service Classes. 

• Default Service Classes. 

If there are no entries for a category, the system suppresses the header for that category. 
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RESOURCE UMITS 


The system Indicates the maximum number of specific system resources you can use. The 
following list shows the resources that appear In this category; 

• Magnetic tape units that may be assigned. 

• Removable auxiliary devices that may be assigned. 

• CPU seconds allowed for each job step. 

• Central memory words allowed. 

• Extended memory words allowed. 

• Jobs that can be detached. 

• Deferred batch files allowed. 

• Permanent files allowed In your catalog.? 

• PRUs available for any one Indirect file. 

• PRUs available for any one direct file. 

• PRUs available for all Indirect files. 

• PRUs available per job. 

• Messages that may be Issued to the dayflles. 

• Batch commands that may be processed. 

• Cards that may be punched per file. 

• Lines that may be plotted per file. 

• Lines that may be printed per file. 

• SRUs allowed per job. 

The maximum number of deferred batch jobs does not apply to you If you have system 
privileges and debug mode Is set on the system display console or If your jobs are of the 
system origin type. 


tThe value SYSTEM denotes that you do not have a static limit for the number of permanent 
files allowed In your catalog. Whenever you Initiate a permanent file operation, the 
system assigns a limit, which can vary with the service class of your job. 
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OTHER CHARACTERISTICS 

This category lists some general characteristics associated with your user name and your 
jobs. The list may include any of the following: 

• User index. 

• Default charge number. 

• Default project number. 

• User prologue. 

• System prologue. 

• Default subsystem for interactive jobs. 

•, Default character set mode for interactive jobs. 

• Expiration dates for your user passwords. 
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USER PERMISSIONS 


In addition to specifying resource limits for certain resources, the system lists special 
that you possess. The following is a list of these special privileges! 

• Change your passwords. 

• Use privileged interactive commands.. 

• Create direct access files. 

• Create indirect access files. 

• Have system origin privileges. 

• Access/create library files. 

• Assign magnetic tapes. 

• Access system without supplying charge/project number. 

• Access or create files on auxiliary devices. 

• Access transaction functions for library updates. 

• Have unlimited terminal connect time without timeout. 

• Use system control point facility. 

• Have special accounting privileges. 

• Have the BIO subsystem privilege to use the V carriage control character in a 
user-specified PFC array in a file. 

• Use the PROTECT command. 

• Transfer permanent files between hosts. 

• Transfer queued files between hosts. 

• Access the NVE subsystem. 

• Specify charge numbers other than the default charge number. 

• Define a password without random characters. 

• Have remote maintenance privileges. 

• Control network processing units (NPUs). 

• Specify an alternate family on a secondary USER command. 

• Specify mainframe logical identifiers (LIDs) on the Job and ROUTE commands. 

• Specify permanent file residence as Locked to Disk (PR=L). 

• Access the system without specifying a personal identifier. 

• Use more than one interactive terminal at the same time. 

• Perform privileged analyst operations if PRIVILEGED ANALYST MODE is enabled. 

• Specify an alternate user name on a secondary USER command. 

• Specify an alternate user name on a routed input file USER command. 

• Specify an alternate family on a routed input file USER command. 


60459680 N 


7-31 




NETWORK APPUCATIONS 


The following are network applications you may be authorized to use; 

• Interactive Facility (lAF). 

• Interactive Transfer Facility (ITF). 

• Message Control System (MCS). 

• Network Operator Utility (NETOU). 

• Network Job Entry Facility (NJF). 

• PLATO - NAM Interface (PLATO). 

• Printer Support Utility (PSU). 

• Remote Batch Facility (RBF). 

• Terminal Verification Facility (TVF). 

• Tieline Facility (TLF). 

• Transaction Facility (TAP). 

• NOS/VE Interactive Facility (VEIAF), 

LOCAL APPUCATIONS 

The system lists local applications you are authorized to use. If there are no such 
applications, this category does not appear in the output. 

PRIVILEGED NETWORK APPLICATIONS 

The system lists the privileged network applications you are authorized to use. The 
Communications Supervisor (CS) is one such application. 

SHEU PERMISSIONS 

The system lists controls applicable to a shell program you write to monitor commands 
entered under your user name. The list Includes the following: 

Clear controls upon loading errors with shell program. 

Clear shell processing if screening program aborts. 

Local file load of shell program. 

Global file load of shell program. 

System library load of shell program. 

Monitor commands from terminal. 
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SECURITY PERMISSIONS 


There are special security-related permissions you may possess. The list may include any of 
the following permissions: 

• Write unlabeled magnetic tapes. 

• Write to or extend a file with an access level lower than your job access level. 

• Lower file access levels. 

• Lower your job access level. 

• Assign an expiration date for a file password or file permission. 

• Assign an expiration date for your user password. 

• Execute on-line diagnostics. 

• Perform security administrator duties. 


SECURITY ACCESS CATEGORIES 

The system lists the access categories you can associate with your permanent files. When 
you create a permanent file, the system associates all categories for which you are 
authorized with this file. You can change this association with the SETPFAC command. 


SECURITY ACCESS LEVELS 

The system lists a set of access levels that deteinnine the access levels at which your jobs 
may run and the access levels at which you may create or access files. 


SERVICE CLASSES 

The system lists all of the service classes you can assign to a job. Your site can further 
restrict the use of a service class to jobs of certain origin types. You can determine 
these restrictions with the CLASS command. 


DEFAULT SERVICE CLASSES 

The system lists the service class it initially assigns to your job if you do not specify a 
service class on the Job command or ROUTE command. This default assignment can vary with 
the origin type of your job. Unlike most other validation limits and privileges, you can 
change this default assignment with the CHVAL command. 
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The following is an example of a user's validation limits: 

/limits 

LIMHS FOR STARSKY FM/NOSCLSH 83/08/09. 17/11/13/ 

MAXIMUM NUMBER OF - 

MAGNETIC TAPE UNITS THAT MAY BE ASSIGNED. 3 

REMOVABLE AUXILIARY DEVICES THAT MAY BE ASSIGNED 2 

CPU SECONDS ALLOWED FOR EACH JOB STEP. IfliJLIMHED 

CENTRAL MEMORY WORDS ALLOWED/100B. 2037B 

EXTENDED MEMORY WORDS ALLOWED/I OOOB. OB 

JOBS THAT CAN BE DETACHED. 3 

DEFERRED BATCH FILES. 8 

PERMANENT FILES ALLOWED IN YOUR CATALOG. UNLIMITED 

PRUS AVAILABLE FOR ANY ONE INDIRECT FILE. 192 

PRUS AVAILABLE FOR ANY ONE DIRECT FILE. 1024 

PRUS AVAILABLE FOR ALL INDIRECT FILES. 4096 

PRUS AVAILABLE FOR JOB. 66048 

MESSAGES THAT MAY BE ISSUED TO THE DAYFILES. 1008 

BATCH COMMANDS THAT MAY BE PROCESSED. UNLIMITED 

CARDS THAT MAY BE PUNCHED PER FILE. UNLIMHED 

LINES THAT HAY BE PLOTTED PER FILE. 512 

LINES THAT MAY BE PRINTED PER FILE. UNLIMHED 

SRUS ALLOWED PER JOB. UNLIMITED 

OTHER CHARACTERISTICS - 

USER INDEX.. 541 OB 

DEFAULT CHARGE NUMBER ASSIGNED. 1234 

DEFAULT PROJECT NUMBER ASSIGNED. 123A456 

SYSTEM PROLOGUE. 2B 

USER PROLOGUE. PROLOG 

INTERACTIVE SUBSYSTEM. BATCH 

INTERACTIVE CHARACTER SET MODE. NORMAL 
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THE FOLLOWING ARE VALID USER PERMISSIONS - 
CHANGE YOUR PASSWORD 
CREATE DIRECT ACCESS FILES 
CREATE INDIRECT ACCESS FILES 
ACCESS/CREATE LIBRARY FILES 
ASSIGN MAGNETIC TAPES 

ACCESS OR CREATE FILES ON AUXILIARY DEVICES 
TRANSFER PERMANENT FILES BETWEEN HOSTS 
TRANSFER QUEUED FILES BETWEEN HOSTS 
SPECIFY LID-S ON JOB AND *ROUTE* COMMANDS 
CHARGE NOT RESTRICTED TO DEFAULT 
DEFINE NON-RANDOMIZED LOGIN PASSWORD 

THE FOLLOWING ARE VALID NETWORK APPLICATONS - 
INTERACTIVE FACILITY (lAF) 

REMOTE BATCH FACILITY (RBF) 

TRANSACTION FACILITY (TAF) 

TERMINAL VERIFICATION FACILITY (TVF) 

THE FOLLOWING ARE VALID SHELL PERMISSIONS - 
PROCESS COIWANDS OUTSIDE CCL PROCEDURE 
SYSTEM LIBRARY LOAD OF SHELL PROGRAM 

THE FOLLOWING ARE VALID SECURITY PERMISSIONS - 
WRITE UNLABELED MAGNETIC TAPES 

THE FOLLOWING ARE VALID SECURITY ACCESS LEVELS - 
ACCESS LEVEL LVLO 

THE FOLLOWING ARE ALLOWED SERVICE CLASSES - 
BATCH (BC) 

REMOTE BATCH (RB) 

INTERACTIVE <TS) 

DETACHED INTERACTIVE (DI) 

THE USER DEFAULT SERVICE CLASS 


FOR BATCH ORIGIN IS.BC 

FOR REMOTE BATCH ORIGIN IS.RB 

FOR INTERACTIVE ORIGIN IS.TS 

INQUIRY COMPLETE. 

/ 
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LISTLID COMMAND 


The LISTLID command lists information on the configuration of your network and on the 
availability of hosts in the network. Information available through LISTLID includes: 

• Logical identifiers (LIDs) and physical identifiers (PIDs) for hosts in the 
network. LIDs are used in certain NOS commands (for example. Job, ROUTE, MFLINK, 
and MFQUEUE) to specify the destination host for a job or file routing operation. 

• The subsystem(s) available to provide network communications. This could be any or 
all of the following: Remote Host Facility (RHF), Network Access Method (NAM), and 
SCOPE 2 Station Facility (SSF). 

• Host characteristics such as local host or linked status, store and forward 
capabilities, and host availability.t 

Note that the site administration has the option of choosing whether information for any 
given LID or PID can be listed using the LISTLID command. 

Format: 


LISTLID,LID=lid,PID=pid,1=lfn 
or 

LISTLID,ST=lid,PID=pid,1=lfn 

Description 

Specifies the LID for which information is to be displayed. If LID=lid 
or ST=lid is specified. Information is listed for the specified LID. 

(The LID and ST keywords are interchangeable; either may be used, but 
not both.) If this parameter is omitted and the PID parameter is also 
omitted, information is listed for all LIDs in the network. 

Specifies that output is to be listed only for LIDs associated with this 
PID. If the LID=lid parameter is also specified, information is listed 
only for that LID. If no LID=lid parameter is specified, information is 
listed for all LIDs associated with this PID. If only the keyword PID 
is specified, information is listed on all LIDs, grouped according to 
their associated PIDs. 

Specifies that LISTLID output is to be written to file Ifn. If this 
parameter is omitted, output is written to file OUTPUT. 


This command lists information on all LIDs in the network for which the site allows 
Information to be listed. The information is listed in output format 1. 

LISTLID,LID=lid,L=lfn. 

This command lists information on all LIDs in the network with the name lid except those 
that the site does not allow to be listed. The information is listed in output format 1 on 
file Ifn. 


tHosts connected through an X,25 network are always considered available as long as the 
network processing unit (NPU) connecting your host to the X.25 network is available. 


Parameter 

LID=lid 

or 

ST=lid 

PID=pid 


L=lfn 

Examples: 

LISTLID. 
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LISTLID,LID=lid,PID=pid. 


This command provides information on the named LID associated with the specified PID. If 
the site does not allow listing of the named LID, or of both the named LID and PID, the 
system returns a dayfile message indicating that the specified LID was not found. If the 
site allows the LID to be listed but not the PID, LISTLID outputs information using format 
2; however, the system will not display the-PID name or the names of available subsystems. 
Instead, the system replaces those names with the characters -. 

LISTLID,LID=lid,PID. 


This command lists all LlDs with the name lid except those that the site does not allow to 
be listed. The specified LIDs are listed under their associated PIDs using output format 2. 

LISTLID,PID. 

This command uses output format 2 to list all LIDs, grouped according to their associated 
PIDs. Any LIDs that the site does not allow to be listed are omitted from the output. Any 
PIDs that cannot be listed are replaced by the characters -. 

LISTLID,PID=pid. 

This command uses output format 2 to list all LIDs associted with the specified PID. Any 
LIDs that the site does not allow to be listed are omitted from the output. If the PID 
cannot be listed, pld is replaced with the characters -. 

LISTLID uses two output formats. Output format 1 is used when the LISTLID command does not 
contain a PID parameter. 


• Example of output format 1: 


LID 

MAINFRAME 


ATTRIBUTE 

NETWORK 

M64 

NOS 964 


LOOPBACK 

RHF,SSF 

M42 

NOS 420 


LINKED 

NONE AVAILABLE 

B2C 

VSOS 


LINKED 

RHF 

MFZ 

SC0PE2 


LINKED 

SSF 

MSI 

NOS MSI 


LINKED 

MAM 

Output format 2 is 

used when a PID parameter 

is specified 

on the LISTLID command. 

• Example of 

output format 2; 




PID LID 

MAINFRAME 

TYPE 

ATTRIBUTE 

RHF NAM SSF 

M64 

M64 

SN 964 

HOST 

HV 

IN NA DISABLED 

LBK 



B 



In output format 2, the attributes listed for each PID are also applicable for each LID 
listed under that PID. In the above example, therefore, LID M64 has the attributes H and V, 
while LID LBK has the attributes H, V, and B. 
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Attributes listed In the ATTRIBUTE column can be listed by name or by mnemonic. 

Attribute Name Mnemonic Description 

host H Indicates that this Is the local host (that Is, the host 

you are logged Into). 

LINKED L Indicates that this host Is linked to your local host. 

STORE FORWARD S Indicates that you can transfer queued files to this 

host through an Intermediate linked host. 

VALIDATION V Indicates that user validation Is performed by the local 

host as well as by the destination host. If this 
attribute Is not listed for your local host, user 
validation Is performed only by the destination host. 

LOOPBACK B Indicates that the LID Is a loopback LID (used for test 

purposes). 

Entries that can be listed In the RHF, NAM, and SSF columns are as follows: 

Entry SIgnlfIcance 

IN Indicates that the link to the PID Is In service. Note that for RHF 

networks and NAM X.25 public data networks, an In service (IN) status Is 
returned whenever the network Is In service, without regard to whether the 
remote host Itself Is available. To determine if the remote host is 
available, you can attempt a file transfer to that host. 

NA Indicates that the subsystem is not available or that no link exists to this 

PID throught this subsystem. 

OUT Indicates that the link to the PID is out of service due to a network fault 

condition. 

DISABLED Indicates that the link to the PID has been disabled by the console operator. 
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MACHINE COMMAND 


Some programs that ran on mainframes other than models 815, 825, 835, 845, and 855 will not 
run on the models 815, 825, 835, 845, and 855 until changes are made in your job. Programs 
most likely to run incorrectly on models 815, 825, 835, 845, and 855 are COMPASS programs 
with tight instruction-modification loops. The MACHINE command enables some of these 
programs to run correctly on these models. 

Format: 


MACHINE,EP=state. 

Parameter Description 

EP=state Specifies whether extended stack purging is selected. EP=ON selects it 
and EP=OFF disables it. 


Instruction stack purging is extended by specifying ON and is made normal by specifying OFF 
and remains in effect until a subsequent MACHINE command or MODE macro alters it. The 
Initial status of stack purging is site—selectable. For more information on stack purging, 
refer to the MODE macro in Volume 4, Program Interface. 

To determine if a program will run correctly on models 815, 825, 835, 845, and 855, run the 
job with extended stack purging disabled (EP=OFF). If unexpected results occur, do another 
run with stack purging extended (EP=ON), When stack purging is extended, the execution time 
of the program may be Increased. If unexpected results still occur, recode COMPASS programs 
or recompile high-level language programs on models 815, 825, 835, 845, and 855. 


MR COMMAND 

The MFL command resets the maximum field length for each subsequent job step. 


Format: 

MFL, CM=nnnnnn, EC ■°mmmm . 
or 

MFL,nnnnnn,mmmm. 

Parameter Description 

CM=>nannnn Specifies the maximum central memory field length (octal is assumed 

unless decimal is specified by a D suffix or use of the digits 8 or 9). 

EC=mmmm Specifies the maximum extended memory field length. The value of tnrnn.n. 
is the actual extended core field length divided by lOOOg. 

The first format- is the order-independent form and the second format is the order-dependent 
form. 
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The parameter nnnnnn sets an upper boundary for the field length of subsequent job steps. 

The value cannot exceed the maximum field length for the job nor can It be less than 1500, 
the field length required for the utility (CONTROL) that processes MFL. If extended memory 
Is assigned for the job, the CM field length cannot be less than 10000. Likewise, the 
parameter mmmm sets an upper boundary for the extended memory field length of subsequent job 
steps and cannot exceed the maximum field length for the job. If the value 0 (zero) Is 
entered for CM or extended memory field length, the MFL Is set to either the maximum field 
length for which you are authorized or the field length specified on the Job command, 
whichever Is smaller. 

The MFL command clears any Initial running field length previously established with the RFL 
command or the SETRFL macro and allows the system to determine the field length for each 
succeeding job step. The system continues to determine field lengths until another RFL 
command or SETRFL macro Is encountered. 

NORERUN COMMAND 

The NORERUN command clears the job rerun status. 

Format: 

NORERUN. 

If the NORERUN command has been Issued, the job may not be rerun. This may be desirable to 
prevent updating of a data base when the job would otherwise be rerun at deadstart or by the 
operator. 

This command is ignored from an interactive origin job. 


NOTE COMMAND 

The NOTE command creates a file containing lines of data entered as a character string on 
the same line as the command. 

Fo rmat: 

N0TE,lfn,NR./linei/line2/•../linen 

Parame ter Description 

Ifn Specifies the name of the file which contains the specified lines. 

Default is OUTPUT. 

NR Inhibits rewind of Ifn. Default is to rewind the file at the beginning 

and end of NOTE command execution. 

/ Specifies the delimiting character used to separate the individual 

entries that become lines in the file. It can be any character. It 
must immediately follow a period or right parenthesis. Multiple 
delimiters generate blank lines. 

linei Specifies the character string which constitutes one line of data in Ifn. 

If a file contains more lines than can be entered with a single NOTE command, a series of 
NOTE commands, each with an NR, can be used. This series should be followed with a PACK 
command since each NOTE command writes an EOR. 
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Example: 


The following sequence of commands creates a procedure file (PFILE) that can insert an input 
record after any record in an existing master file (LISTFIL). 

NOTE,PFILE,NR.+.PROC,INSERT*!,N.+SET,LISTFIL.+C0PYBR,L1STFIL,NEWLIST,N. 

NOTE,PFILE,NR.+COPYBR,1NPUT,NEWLIST.+COPYEI,LISTFIL,NEWLIST. 

NOTE,PFILE,NR.+REPLACE,NEWLIST=LISTFIL. 

PACK,-PFILE. 

SAVE,PFILE. 

To insert an input record after the second record in LISTFIL, the user includes the 
following command in the job that contains the new input record. 

BEGIN,INSERT,PFILE,2. 


OFFSW COAAMAND 

The OFFSW command clears the sense switches for reference by one of your jobs. 

Format: 

0FFSW,swltchj^,swltch2,.. . jSwitchn.j sn. 

Parameter Description 

switch^ ' Specifies the switches to be cleared. You must denote each switch^ by 
an integer in the range of 1 through 6. If you specify 0 for this 
parameter, the system clears all sense switches. 

jsn Specifies the job sequence name (JSN) of the job whose sense switches 

will be changed, jsn is an optional parameter; its default is the JSN 
of the current job. The systeo recognizes the jsn parameter by its 
alphabetic characters; therefore, jsn can appear anywhere in the 
parameter list and can be omitted without leaving a blank parameter 
field. 

Refer to the description of the ONSW command for further information on sense switch 

settings. 
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ONSW COMMAND 


The ONSW command sets the sense switches for reference by one of your jobs. The system 
stores the sense switch settings in your control point area and copies them to RA at the 
beginning of each job step for use by the central program. The sense switch field in the 
control point area and the one in RA are updated separately. 

Format; 

ONSW, switchi, swi tch 2 ... tchjj, j sn . 

Parameter Description 

switch^ Specifies the switches to be set. You must denote each switch^ by an 
integer in the range of 1 through 6. If you specify 0 for this 
parameter, the system sets all sense switches. 

jsn Specifies the job sequence name (JSN) of the job whose sense switches 

will be changed, jsn is an optional parameter, its default is the JSN 
of the current job. The system recognizes the jsn parameter by its 
alphabetic characters; therefore, jsn can appear anywhere in the 
parameter list and can be omitted without leaving a blank parameter 
field. 

You can also use the SWITCH command to set the sense switches. 


PASSWOR COMMAND 

The PASSWOR command changes the passwords associated with your user name. To use PASSWOR, 
you must be authorized to change your password. (Refer to the LIMITS command to determine 
if you are authorized to change your password.) Your user name has two passwords: 

• The interactive password, which must be entered when logging in. 

• The batch password, which must be included in batch and remote batch jobs. 

You may specify the password you want the system to change. If you omit this parameter 
selection, the system changes the password that matches the origin type of your job. That 
is, a PASSWOR command in an interactive job changes your interactive password; a PASSWOR 
command in a batch or remote batch job changes your batch password. Your site may elect to 
have the system change both passwords when you do not specify the password type to change. 

If your site uses the password randomization feature, you can enter the PASSWOR command 
only from an interactive job. When you select a new password, the system appends a 
site-determined number (from two to five) of randomly generated characters to it. 

Format: 

PASSWOR,oldpassword,newpassword,XD=expiredate,PT“passwordtype. 

or 

PASSWOR,oldpassword,newpassword,XT=expireterm,PT=passwordtype. 
or 

PASSWOR. 
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Parameter 


Description 


Specifies the old password. This is a required parameter if 
password randomization is used. 

Specifies the new password. The new password must not be more than 
seven characters long. Your site determines the minimum length of 
passwords (4 is the default). This is a required parameter if 
password randomization is used. 

Specifies the expiration date for the password. The value 
expiredate must be a six-digit string of the form yymmdd, where yy, 
mm, dd are two-digit year, month, and day designators, 
respectively. The latest date you can specify and the default 
expiration date are site-determined. 

You must have special authorization to specify an expiration date 
for a password (refer to the LIMITS command). 

Specifies the life of the password in days. If you specify 0, the 
password expires immediately. If you specify 4095 or *, the 
password does not expire. The default expiration term and the 
maximum expiration term are site-determined (no site can choose a 
value greater than 4095). 

You must have special authorization to specify an expiration term 
for a password (refer to the LIMITS command). 

Specifies the type of password to be changed. 

passwordtype Description 

B Batch. 

I Interactive. 

IB or BI Both batch and interactive. 

If you omit the FT parameter, the password that matches the origin 
type of your job is changed. If your site elected to change both 
passwords when this parameter is omitted, both passwords are 
changed. 

You cannot specify a new expiration date (using either XD or XT) without also specifying the 
oldpassword and newpassword parameters. Also, if you omit both the XD and XT parameters 
when you enter the PASSWOR command, the default expiration date is the current date plus the 
site-determined expiration term. 

The first and second formats of the PASSWOR command can be entered either from batch or 
interactive jobs. These formats cannot be used if the password randomization feature is 
used. 

The use of the third format of the PASSWOR command is dependent on whether or not your site 
uses the password randomization feature. 

For sites that do not use password randomization, the third format of the PASSWOR command 
can be used for added security and can be entered from either an interactive or batch job. 
When entered from an interactive job, the system prompts you to enter the password type, the 
old password, the new password and the new password again for verification. If you are 
authorized to set an expiration date, the system also prompts you for an expiration date or 
term. When entered from a batch job, the third format of the PASSWOR command can be used 
only to change the batch password. The system reads the parameters from a record in file 
INPUT. This record must be a single line of the format: 


oldpassword 

newpassword 


XD=expiredate 


XT=expireterm 


PT=passwordtype 
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oldpassword,newpassword 


or 

oldpassword.newpassword,expiredate 
or 

oldpassword,newpassword,explreterm 

For sites using password randomization, the third format is the only valid format, and it 
must be entered from an interactive job. 

PAUSE COMMAND 

The PAUSE command sets the pause bit of one of your executing jobs. 

Format: 

PAUSE,jsn. 

Parameter Description 

jsn Specifies the job sequence name (JSN) of the job whose pause bit you 

want to set. 

You must check the status of the pause bit to effectively use this command. The program 
does not pause just because the pause bit is set. Similarly, the program does not proceed 
just because the pause bit has been cleared. You can write a program that checks the status 
of the pause bit and waits for that bit to be cleared (refer to the RECALL macro in Volume 
4, Program Interface). 

If you want to determine whether a PAUSE or GO command has been entered, write a program to 
set bit 13 of word RA and then status it. The system unconditionally clears bit 13 of word 
RA whenever the PAUSE/GO command sets/clears the pause flag (bit 12 of word RA). Hence, 
when the system clears it, you can check the pause flag. CPU programs that check the pause 
flag on NOS 1 continue to work properly on NOS 2, but these programs cannot determine when a 
PAUSE or GO command has been entered. 


PROTEa COMMAND 

The PROTECT command is used to activate or deactivate preservation of the extended memory 
assigned to your job field between job steps. Ordinarily, the extended memory assigned to 
your job is zeroed at the completion of a job step. With EC“ON, it is preserved between job 
steps. 

You must be authorized to use the PROTECT command (refer to the LIMITS command in this 
section). 


NOTE 


The PROTECT command inhibits the release of 
extended memory by the system between job 
steps. However, if the LOADER is called to 
load an absolute program or program overlay, 
PRESET must be defined as NONE with an LDSET 
command to the LOADER or with the LOADER 
build directive PRESET=NONE at the time that 
the system is built. If PRESET=NONE is not 
defined, then extended memory is not 
preserved across job steps regardless of the 
status of the PROTECT command. 
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Format: 


PROTECT,EC=state. 
or 

PROTECT,state. 

Parameter Description 

EC=state Activates or deactivates extended memory preservation. You can specify 
two values for state: 

state Description 

ON Activates the preservation of memory. 

OFF Deactivates the preservation of memory. OFF is the default. 


QGET COMMAND 

The QGET co mm a n d assigns a queued file to your job. You must specify the job sequence name 
(JSN) or the user job name (UJN) associated with the queued file. Unless explicitly routed 
elsewhere, the file remains with your current job. If a local file already exists with the 
same name as the queued file, the QGET operation is aborted. 

Format: 


QGET,JSN=j sn,DC=q,UJN»uj n,FN=lfn,OP=NA,DQ=dqopt. 
or 


QGET,jsn,q,ujn,lfn,NA,dqopt. 


Parameter 
JSN=j sn 


DC=q 


Description 

Specifies the four-character, system-generated JSN associated with the 
queued file. 

Specifies the disposition of the queued file. WT is the default. 


9 

Description 

PR 

Print 

PU 

Punch 

PL 

Plot 

WT 

Wait 

IN 

Input 


UJN“ujn Specifies the UJN associated with the queued file. 

FN=lfn Specifies the local file name for the queued file. If specified, the 

JSN is the default local file name. Otherwise, the default is the UJN. 

OP=NA Instructs QGET to continue processing when the specified file is not 

found or any other non—syntactical error occurs. 
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Parameter 


Bescription 

DQ=dqopt Specifies whether the file is removed from the queue. The default is 
YES. 

dqopt Description 

NO File remains - queued with the same disposition and deferred - 
routing. The file may not be modified. 

YES File is removed from the queue. 

If you do not specify a JSN or a UJN, QGET is aborted. If you specify a UJN associated with 
two queued files with the same disposition or if a local file already exists with the same 
name as the queued file, QGET is aborted unless OP=NA was specified. If no queued file 
exists with a JSN and/or UJN which you specified, QGET is aborted unless OP=NA was specified. 

QUEUE? COMMAND 

The QUEUE? command allows you to examine the system batch queues in linked SCOPE 2 systems. 
The QUEUE? command has two formats: 

QUEUE?,ID=pid,L=lfn,pi,P 2 ,P3,P4. 
or 

QUEUE?,help. 

Parameter Description 

lD“pid Specifies the physical identifier (PID) of the SCOPE 2 mainframe to be 

searched. If no PID is specified, all mainframes are searched. This 
parameter may be specified with the parameter name (ID) and equal sign 
omitted. 

L=lfn Specifies the name of the file to receive the QUEUE? output. The 

default is OUTPUT. 

Pi Specifies the SCOPE 2 queues (input, output, execute, or punch) to be 

displayed. Valid options for p^ are listed below. From one to four 
options can be specified. The default is E. 

Pi Description 

A lists jobs found in all queues (E, I, 0, and P). 

E Execute queue; lists the SCOPE 2 R display. Figure ?-l 

provides an example of an execute queue listing. 

I Input queue; lists the SCOPE 2 R display for input. Figure 

?-2 provides an example of an input queue listing. 

0 Output queue; lists the SCOPE 2 H display for output. 

Figure ?-3 provides an example of an output queue listing. 

P Punch queue; lists the SCOPE 2 H display for punch output. 

Punch queue listings are the same as output queue listings, 
as shown in Figure ?-3. 
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Parameter 


help 



Displays the command format or the physical identifiers for all 
available SCOPE 2 mainframes. The following are valid entries for the 
help parameter. 


help Description 

ID Displays physical identifiers for all SCOPE 2 mainframes in 
the network. 


SYNTAX Displays the QUEUE? command format, 
or 
S 


/queue?,e 








JOBS 6/ 52/ 

?0 R(Z),1. 







ORD ACTION 

JOBNAME PRTY 

JOB 

TIME TIME 

LCM 

JOB BG 

ID 

ORIGIN 

USED LEFT 

IN USE 

STAT 

TYPE 

FIRST ACTION MESSA6E/UST 

DAYFILE MESSAGE 


3 M06/** 

JOBXXXZ 4000 

M06/** 


0 ? 


26 

PA US 

REPONSE 

PAUSE. 00 NOT 

GIVE A 

GO. 

TESTING 

ON 

606 


4 M06/** 

JOBXXXZ 4000 

M06/** 


0 ? 


26 

PA US 

RESPONSE 

PAUSE. DO NOT 

GIVE A 

GO. 

TEST ING 

ON 

606 


5 M06/** 

JOBXXXZ 4000 

M06/** 


0 ? 


26 

PA US 

RESPONSE 

PAUSE. DO NOT 

GIVE A 

GO. 

TESTING 

ON 

606 


QUEUE? COMPLETE 









Figure 7-1. QUEUE? Execute Queue Sample Listing 


Colimn headers for the QUEUE? execute queue listing have the following meanings: 

Header Description 

CSID The job ordinal. 

ACTION ID The station/terminal Identifier of the terminal from which the job expects 
a response; present only when the job requires a response. 

JOBNAHE Job name of the executing job. 

PRTY Priority of the job; must be in the range of 0 to ????g. 

JOB ORIGIN Station/terminal identifier of the terminal from which the job was 

submitted. 


TIME USED CPU seconds used by the job. 

TIME LEFT CPU seconds remaining for execution. 

LCM IN USE Number of LCM buffers in use by the job. 

JOB STAT Current processing state of the job. 

Indicates that the job will be scheduled as a background priority job. 


BG 

60459680 D 


?-4? 



FIRST ACTION MESSAGE/ 
LAST DAYFILE MESSAGE 


If there are action messages for the job, the message is the first action 
message; otherwise, the message is the last dayfile message. 

ACTION Indicates that the above message requests an operator 

action such as a tape mount. 

CFO RESP Indicates that the above message requests the operator to 
respond with a CFO type entry. 

RESPONSE Indicates that the above message requests the operator to 
respond with a command such as GO or DROP. 


/ que ue7, i 








SFTS 

10/ 172/ 

172 H(Z) 

,1,103. 





ORO 

FILENAME 

FILE PRTY 

DEVICE-REQUIRB1ENTS 

TIME 

DEPEND BG 



ORIGIN 

HT NT 

YD YL 

SM SN SP 

LIMIT 


107Z 

JOBXXXZ 

M06/** 1002 

0 0 

0 0 


10 

0 

110Z 

JOBXXXZ 

M06/** 1002 

0 0 

0 0 


10 

0 

STATION M06 

M02 MFF 

MO 5 

MSD 

HFU 

UKWN TOT 



INPUT 

2 

0 0 

0 

0 

0 

0 2 



OUTPUT 

1 

0 0 

0 

0 

0 

0 1 



PUNCH 

0 

0 0 

0 

0 

0 

0 0 



QUEUE? COMPLETE 









Figure 7-2. QUEUE? Input Queue Sample Listing 
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Column headers for the Q0EUE7 input queue listing have the following meanings: 

OKD Input queue suffixed with the last letter of the SCOPE 2 physical 

identifier. 

FILENAME File name of the input job as specified on the job card. 

FILE ORIGIN Identifier of the station/terminal from which the job was submitted. 

PRTY File priority; must be in the range from 0 to 7777g, 

DEVICE- The number of magnetic tape or disk devices assigned to the job. 

REQUIREMENTS 

TIME LIMIT Job time limit as specified on the job card. 

DEPEND A two-character dependency identifier as specified on the job card. 

BG Indicates that the job will be scheduled as a background priority job. 


/queue7,o 









SFTS 10/ 

172/ 

172 

H(Z) 

,0,103 

- 




ORD FILENAME 

FILE 

PRTY 

OISP 

FORM 

FILE 

FILE IN 



DESTIN 


CODE 

CODE 

SIZE 

TRANSFER 

111Z JOBXXXZ 

H06/** 4003 

PR 


1 

N 

STATION 

M06 

M02 

MFF 

M05 

MSD MFU 

UKWN 

TOT 


INPUT 

2 

0 

0 

0 

0 0 

0 

2 


OUTRJT 

1 

0 

0 

0 

0 0 

0 

1 


PUNCH 

0 

0 

0 

0 

0 0 

0 

0 


QUEUE? COMPLETE 








Figure 7-3. Q0EUE7 Output Queue Sample Listing 
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Column headers for the QUEUE? output queue listing have the following meanings: 


ORD 


Output queue ordinal suffixed with the last letter of the SCOPE 2 physical 
identifier. 


FILENAME File name of the output file as specified on the job card. 

FILE DESTIN Station/terminal identifier of the terminal to which the output file is to 
be routed. 


PRTY 

DISP CODE 
FORM CODE 


File priority. Must be in the range from 0 to 7777g. 
File disposition code. 

Forms code of the file. 


FILE SIZE File length in PRUs. 


FILE IN Indicates whether or not the file is currently being transferred to a 

TRANSFER station. Possible values are Y for yes, and N for no. 


REDO COMMAND 


The REDO command allows you to modify and reenter a previously entered command without 
retyping the entire command. 

Format: 

REDO,string/GO. 

or 

R,string/GO. 

Parameter Description 


Specifies the initial characters of the command to be modified and 
reentered, string can be up to 10 characters long. If string is 
specified, the system searches for the most recently entered command 
beginning with that string. If string contains one or more leading 
blanks or asterisks, the command to be located may have leading blanks. 
If string is omitted, the system reenters the command immediately 
preceding the REDO command. 

Reenters the specified command without modification. Display of the 
OLD:, MOD:, and NEW: prompts is suppressed. 

note I 

The GO option is forced on noninteractive jobs. 

When you enter the REDO command, the system prints the characters OLD:, followed by the 
command to be modified, with leading blanks removed. On the next line, the system prints 
the characters MOD: as a prompt for you to enter modifications to the line. You enter 
modifications using the modification symbols described below. When you finish your 
modifications and enter a carriage return, the system removes- leading blanks from the 
modified line, prints the characters NEW:, followed by the modified line, then executes the 
command. Following is an example of a CATLIST command that is altered to specify a 
different file name: 

/REDO 

OLD: CATLIST,LO=F,FN=BTK 
MOD: fac 

NEW: CATLIST,LO=F,FN=FAC 


string 


GO 
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In this example, the user spaced over to the last three characters in the line and typed in 
a new file name. 

The REDO command modification symbols are as follows: 

Symbol Effect 

space Leaves the character unchanged. 

# Deletes the character and shifts the remainder of the line one character to 

the left. 

& Replaces the character with a space. 

A Inserts a character string before the character marked by the a. The 

inserted string is terminated by a # or a carriage return. If a A is 
followed immediately by a carriage return, the line is redisplayed as 
modified up to that point, and further modifications are allowed. 

! Deletes the remainder of the line. 

other Any other character entered replaces the original character. 

Example: 

/REDO 

OLD: RECLAIM/DUMP,TN=MYVSN,PF=*/ALPHA,GAMMA=BETA 

MOD; A,Z.# DF FILADT=MS, 

NEW: RECLAIM,!./DUMP,DF=MYFIL,DT=MS,PF=*/ALPHA,GAMMA=BETA 


RERUN COMMAND 

The RERUN command sets job rerun status. 

Format: 

RERUN. 

If the RERUN command has been issued, the operator can rerun the job if necessary. This 
command is Ignored from a Interactive origin job. 


RESOURC COMMAND 

The RESOURC command is required in any job chat uses more than one tape or removable 
auxiliary pack concurrently. It prevents deadlocks with other jobs that may need the same 
resources. You do not need to use a RESOURC command if you have only one multivolume tape 
file or multipack disk file because the system treats each as only one resource unit. 
Nonremovable auxiliary packs should not be specified on the RESOURC command. (Nonremovable 
packs are always available to all users.) 


I NOTE I 

The RESOURC command should precede the first 
tape or pack request in a job. 
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Format: 


RESOt3RC,rti=ui/leveli,rt2=U2/level2, ,rtn=u=ji/levels. 

Parameter Description 

rti Resource type: 


liO ' 
HI 

m 

HD 

PE 

6E 

CT 

AT 

Mxt 

Nrt 

DBm 

DCm 

DDm 

DFm 

DGm 

DHm 

Dim 

DJm 

DKm 

DIai 

DMn 

DH 

DQm 

EAn 

EBn 

ECn 

EDn 

EE 

EF 


4K sector) 


16K sector) 


200-cpi, 7-track magnetic tape unit 
556-cpi, 7-track magnetic tape unit 
800-cpi, 7-track magnetic tape unit 
800-cpi, 9-track magnetic tape unit 
1600-cpi, 9-track magnetic tape unit 
6250-cpi, 9-track magnetic tape unit 
38000-cpi, cartridge magnetic tape unit for CTS 
38000-cpi, cartridge magnetic tape unit for ACS 
Seven-track magnetic tape unit 
Nine-track magnetic tape unit (800/1600-cpi) 

885-42 Disk Storage Subsystem (l<m<3) 

895 Disk Storage Subsystem (l<m<2) 

834 Disk Storage StOssystem (l<m<8) 

887 Disk Storage Subsystem 
836 Disk Storage Subsystem (l<mi3) 

887 Disk Storage Subsystem (1^<,2; 

844-21 Disk Storage Subsystem (l^m^S) 

844-41/44 Disk Storage Subsystem (l<m<8) 

844-21 Disk Storage Subsystem (full-track; lim<8) 

844-41/44 Disk Storage Subsystem (full-track; 1 ot< 8) 
885-11/12 Disk Storage Svibsystem (half-track; l<m<3) 

9853 Disk Storage Siobsystem 

885-11/12 Disk Storage Subsystem (full-track; l<m<3) 

5830 Disk Array Subsystem; one 5832 SSD drive used in serial 
mode (1^<8) . 

5830 Disk Array Subsystem; two 5832 SSD drives used in 
parallel mode (l<m<6) . 

5830 Disk Array Subsystem; 
serial mode (lim<2). 

5830 Disk Array Subsystem; two 5833 SABRE drives: one for 
data and one for parity (l<m<.2) . 

5830 Disk Array Svibsystem; two 5833 SABRE drives used in 
parallel mode. 

5830 Disk Array Subsystem; three 5833 SABRE drives: two for 
data and one for parity. 


one 5833 SABRE drive used in 


The value m denotes the number of units (spindles) required for a 
particular auxiliary disk file that you access in your job. In this 
case, the rti value must correspond to the R=r specification on the 
permanent file command that references the disk pack (refer to section 
10 ) . 


ui Maximum number of units of resource type rti this job will use 

concurrently; any rtisui entry can be changed on subsequent RESODRC 
commands. (Refer to Altering Resource Requirements.) An rt=0 entry can 
be entered to clear a resource type that is no longer required. 


t Retained for conpatibility with NOS 1.2. Refer to restrictions described under Tape Units 
in this section. 


60459680 P 


7-51 



Parameter 


Description 


level Specifies the security access level at which you want to access magnetic 
tape units. The parameter is ignored for ainciliary disk packs. Onless 
changed by your site, level can be one of the following names: 

LVDO, LVLl, LVL2, LVL3, LVL4, LVL5, LVL6, or LVL7 

The default is the current job access level. 

On a secured system, the access level you specify must be valid for the 
job (ENQUIRE,B returns this information) and for the device to which you 
are assigning the file. 

On an unsecured system, the parameter has no effect. The system does, 
however, check for valid parameter specifications. 


DEADLOCK PREVENTION 

The system manages the use of tape units and disk packs so as to prevent deadlocks frcxn 
occurring. A deadlock mectns that the system, by assigning a tape unit or pack to one job, 
prevents another job with currently assigned resources from ccmpleting. For example, an 
installation with two tape units is processing jobs A and B. Each job needs both units 
during some phase of processing. Job A is assigned unit 1. If job B were assigned unit 2, 
neither A nor B could cc«p>lete until the other job relinquishes its assigned unit. 

To prevent deadlocks from occurring, the system requires that a RESOURC command be included 
in any job that uses more than one tape or disk pack concurrently. Thus, in the previous 
example, a RESOURC conmauid is required in both jobs. The information supplied by the 
commands enables the system to anticipate the deadlock situation and roll out job B until 
job A no longer needs both units. When the RESOURC canmand is executed, the system first 
checks if the specified number of luiits exceeds the number of units you are authorized to 
use or the number of unite available at the installation.t If either of these situations 
occurs, the system issues an error message to your dayfile and aborts the job. (Refer to 
figure 7-4.) 


t For jobs that use only one tape or pack at a 
the system checks validation limits when the 


time and do not contain a RESOURC ccxnmand, 
request is made. 
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Figure 7-4. Resource Commltaiient Processing (Simplified) 

When the job requests a tape or pack,t the system compares the nianber of units that jobs 
being processed have scheduled via RESOURC commands with the number of units actually 
assigned. If it determines that the assignment would cause a deadlock (refer to Resource 
Overcommitment), it rolls out the job until a deadlock would not occur. If the assignment 
would not cause a deadlock, the system searches for the requested tape or pack. If found, 
it is assigned to the requesting job. If the pack is not found and the N4 keyword was 
Included in the request or if the tape is not found, the requesting job is rolled out until 
the operator makes the pack or tape available. 


-tRefer to Permanent File Commands in section 9 for a description of disk pack requests 
and tc Tape Management Commands in section 12 for a description of tape requests. 
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NOTE I 


If a job already has a tape or pack assigned 
when the RESOURC command is issued and the 
system determines that the assignment would 
cause a deadlock, the job aborts and the 
system issues a RESOURCE DEMAND ERROR 
message. 


SINGLE RESOURCE USE 

A job that uses only one tape or disk pack concurrently does not need to specify resource 
demand with a RESOURC command. However, before assigning the same or a different type of 
resource, the current single resource (tape or disk pack) must be returned with either the 
RETURN or UNLOAD command. To allow more flexible resource handling, both the RETURN and 
UNLOAD functions decrement the default resource demand count from one to zero for jobs 
requiring only one tape or disk pack concurrently. For those jobs requiring more than one 
tape or disk pack concurrently (as specified by the RESOURC command), UNLOAD does not 
decrement the resource demand count; RETURN decrements the resource demand count only when 
all concurrent resource demands have been satisfied. 


TAPE UNITS 


The system supports nine-track magnetic tapes in three different densities. In system 
commands, you use a 2-character density resource identifier to specify the correct density. 
The identifiers are as follows: 


Identifier 

HD 

PE 

GE 


Density 

800 cpi 
1600 cpi 
6250 cpi 


The 679-2/3/4 tape units are capable of processing both 800-cpi and 1600-cpi nine-track 
tapes; the 679-5/6/7 tape units handle both 1600-cpi and 6250-cpi nine-track tapes. An 
800-cpi nine-track tape cannot be processed on a 1600/6250-cpi unit, and 6250-cpi nine-track 
tape cannot be processed on an 800/l600-cpi unit. The NT resource identifier, retained for 
compatibility, can be used only to allocate 800/1600-cpi nine-track units and cannot be 
specified concurrently in the same job with HD, PE, and GE resource demands. Default 
nine-track resource allocation is by density. 


Examples: 


Assume that an installation has the following tape drive resources: 

• Two 679-4 nine-track tape drives (800/1600-cpi densities). 

• Two 679-7 nine-track tape drives (1600/6250-cpi densities). 


1. If a job makes a tape unit resource request with 
RES0URC,NT=3. 

the job is aborted with the message 
INSUFFICIENT RESOURCES ON SYSTEM. 


because only two units (the 679-4s) meet the NT specification. 
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2. If a job makes a tape unit resource request with 

RESOURC,NT-1,PE=1. 
the job is aborted with the message 
CONFLICTING RESOURCE TYPES. 

because the NT specification cannot be used with a density specification 
<HD/PE/GE). 

3. If a job contains the following commands 

IABEL,TAPE,NT,D=PE,VSN=TAPE1. 

RESOURC,NT-2. 

the Job is aborted with the message 
CONFLICTING RESOURCE TYPES. 

because the LABEL command requested a tape unit by density (the default); 
therefore, later commands cannot schedule tape units using the NT specification. 

Density identifiers are provided for seven-track tape units even though these units do not 
have alternate densities. This is done for consistency of format. The LO, HI, HY, and MT 
resource identifiers are all equivalent, and the last specification of any one of these is 
the seven-track tape unit demand for the job. For example, the resource request 
RES0URC(HI=1,HY=2) results in two seven-track tape resources being allocated for the job. 


RKOURCE OVERCOMMITMENT 

Under certain conditions, the system overcommits resources, provided all jobs with currently 
assigned resources can complete. For example, an installation with three tape units is 
processing jobs A and B. Included in each job is a RESOURC command scheduling two units. 

Job A requests its first tape. It is assigned the tape (unit 1) because there are enough 
units available for job A to complete. Job B requests its first tape. It is assigned the 
tape (unit 2) because either A or B can complete if assigned the last unit, and when the job 
that is assigned the last unit completes, the other can then use that unit and also 
complete. Job B then requests and is assigned its second tape (unit 3). It completes its 
operations (that is, terminates or returns the files on the tape) and makes the »init 
available for job A to complete. 


1 NOTE I 


In a multimainframe environment, only the 
configuration of the machine on which the 
job is processed is considered in the 
overcommitment algorithm. 


60459680 D 


7-55 



ALTERING RBOURCE REQUIREMENTS 


The system manages its resources by keeping totals of the number of units of each device 
type scheduled and assigned to jobs. The number of units scheduled and the number of units 
assigned to a job can vary during job processing. 

To change the number of units of a device type scheduled for this job, you can issue another 
RESOURC command. When decreasing the number of units scheduled for the job via a RESOURC 
command, the total resulting scheduled units must not be less than the number of units 
currently assigned to the job. If the resulting total would be less than the number 
currently assigned, the system aborts the job with an error message. 

If the job has tape and/or removable pack units assigned to it when it attempts to increase 
its resource demands, the system determines if the request would cause a deadlock. If it 
would, it aborts the job with an error message. 


NOTE 


Always return all units assigned to your 
job before issuing another RESOURC command 
to increase resource demands. This action 
prevents a possible job abort caused by a 
potential deadlock condition. 


The scheduled units can also be decreased by a RETURN command if the job, at the time of the 
return, is using its maximum scheduled units (refer to the description of the RETURN command 
in section 9). 

Example: 

The first RESOURC command schedules two 1600-cpi, nine-track tape units. The two LABEL 
commands assign the tape units to the job. Because the maximum scheduled units were used 
concurrently, the RETURN command decreases the scheduled tape units to zero. The second 
RESOURC command schedules two 844-21 disk units and one 1600-cpi, nine-track tape unit. 

SAMSJOB,CH50000,T40. 

USER^SJGREEN^WGT. 

CHARGE,*. 

RES0URC,PE=2. 

LABEL,X,D=PE,VSN=TAPE1. 

LABEL,Y,D=PE,VSN=TAPE2. 

RETURN,X,Y. 

RES0URC,DI1=2,PE=1. 


-EOI- 
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UNIT ASSIGNMENT 


The method of assigning units depends on the resource type. For example, all tapes and all 
private disk packs not accessible by alternate users can only be assigned to one job at a 
time. All public packs and those private packs accessible by alternate users are shareable, 
and therefore, can be assigned to several jobs at the same time. 

On indirect access file requests, the pack is charged to the job in fulfilling its resource 
demand only if the request causes the pack to be mounted. For direct access file requests, 
the pack is charged to the job when the first ATTACH of a direct access file is made. 

A unit is assigned to a job until the job terminates or all direct access files residing on 
the unit that are assigned to the job are returned. At this point, a tape or a nonshareable 
pack can be dismounted. A shareable pack, however, can be dismounted only when there are no 
files residing on the unit that are assigned to any of the jobs sharing the pack. 


I NOTE 


In GET requests for indirect access files, 
a pack is assigned to a job only as long as 
the pack is actually being used (that is, 
until the system retrieves the local copy 
of the file). Therefore, during a series 
of GET requests, the operator may determine 
that the pack is not being used and dis¬ 
mount it. If you have a direct access file 
on the pack, you can avoid this situation 
by attaching the direct access file before 
issuing the GET requests. 


A single job cannot have more than 36 removable pack devices attached to the job 
concurrently. 


RFL COMMAND 

The RFL command sets the initial running field length for each subsequent job step when 
neither the routine for processing that step nor a loader table specifies a field length 
(refer to Field Length Control in section 3). 

Format: 

RFL, CM=nnnnnn, EC=miimim. 
or 


Description 

Specifies the central memory field length (octal is assumed unless 
decimal is specified by a D suffix or use of the digits 8 or 9). The 
value is rounded up to the nearest multiple of lOOg. 

Specifying nnnnnn as 0 removes the effect of the previous RFL command 
and returns the setting of the field length to system control. 

Specifies the extended memory field length in octal. The value of 
mmmm is the actual extended memory divided by lOOOg. 


RFL, nnnnnn, mmmm. 

Parameter 

CM=nnnnnn 


EC^nuDiniii 
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The parameters may be specified positionally, by keyword, or intermixed positionally and by 
keyword. If intermixed, the positional parameters are evaluated according to their position 
among all the parameters. 

The values of nnnnnn or mmmm cannot exceed the values specified on the last MFL command or 
the maximum allowed for the job. 

Prior to the appearance of the RFL command (-or SETRFL macro), the system determines the 
field length for each job step, provided no field length is specified by a system routine or 
loader table (refer to Field Length Control in sections). 


ROLLOUT COMMAND 

The ROLLOUT command suspends job execution and places the job in the rollout state. This 
releases the control point, central memory, and extended memory assigned to the job. You 
can specify a time period that must elapse before the job is returned. Otherwise, the job 
scheduler usually returns the job to execution when its priority is the highest of the jobs 
rolled out (refer to Rollout Control in section 3). 

Format: 

ROLLOUT,t. 

Parameter Description 

t Optional time delay measured in job scheduler delay intervals. Values 

for t range from 0 to 262080 (777700s) intervals. Although the 
default base is decimal, octal values can be specified by a B suffix. 

Typically, a job scheduler delay interval is one second but can be site-determined. 


RTIME COMMAND 

The RTIME command requests that the time be read from the real-time clock and Issued to the 
dayfile (in seconds). This is the accumulated time since the last system deadstart. 

Format: 

RTIME. 

The dayfile message format is: 

RTIME nnnnnn.nnn SECS. 
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SETASL COMMAND 


The SETASL command sets the system resource unit (SRU) limit for an account block. An 
account block is the job step sequence whose execution is charged to an account (refer to 
SRU Limit Control in section 3). The account is specified by the charge and project numbers 
on a CHARGE command, or if no CHARGE command is required, by the user name on the USER 
command. Each user name and each account has an SRU validation limit (refer to the LIMITS 
and ENQUIRE commands). Except for interactive jobs, the default account block SRU limit 
(set during CHARGE or USER command processing) is the smaller of the user name and the 
account validation limits. For interactive jobs, the default limit is 64 SRUs. 

Format; 

SETASL,s. 

Parameter Description 

s Maximum number of SRUs allowed for account block execution. Although 

the default base is decimal, octal values can be specified by a B suffix 
on the value. 

If s is an asterisk (*), or has a value of 219904 (655400B) or greater, 
or has a value greater than your validation limit, the account block SRU 
limit is then set to your validation limit. Also, if s is less than 
your current job step SRU limit (refer to the SETJSL command in this 
section for a description of the job step SRU limit), both the account 
block and job step SRU limits are set to s. 

A dayfile message is then issued indicating what the new values are for 
the account block. SRU limit (ASL) and job step SRU limit (JSL). 

If the account block SRU limit is reached during account block execution, the system issues 
an error message and terminates the job (refer to Exit Processing in section 5). 
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SETCORE COMMAND 


The SETCORE command presets each word within the field length except for RA+2. 

Format: 

SETCORE,p. 
or 

SETCORE,-p. 

Parameter Descripton 

p Any of the following: (If a minus sign precedes the parameter p, the 

complement of p is set in core.) 

p Fill Characters 

0 0 

ZERO Zeros (0) 

INDEF Indefinite (1777 0000 0000 0000 0000) 

INF Infinite (3777 0000 0000 0000 0000) 

Each word within the field length (except for RA+2) is set to p. If p is omitted, the 
system assumes p=0. 

Calling the CYBER loader destroys the effect of a SETCORE command since the loader uses 
memory as a work area. 

To preset memory within a load sequence, use a LDSET,PRESET command as described in the 
CYBER Loader Reference Manual. 
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SETJAL COMMAND 


The SETJAL command changes the security access level of the current job. Initially, your 
job has the lowest possible access level that is valid for your job (ENQUIRE,B returns this 
Information). Refer to Security Features in Section 3 for a detailed discussion of access 
levels. 

Format: 

SETJAL,AL=level. 

Parameter Description 

AL=level Specifies the security access level you want assigned to the job. 

Unless changed by your site, level can be one of the following names: 

LVLO, LVLl, LVL2, LVL3, LVL4, LVL5, LVL6, or LVL7 

On a secured system, the access level you specify must be valid for the job. In addition, 
to lower the access level of your job, you must be authorized to do so (refer to the LIMITS 
command). 

On an unsecured system, the command has no effect. The system does, however, check for 
valid parameter specifications. 
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SETJOB COMMAND 


The SETJOB command changes some of the current job's attributes. You can change the user 
job name (UJN), can redirect the disposition of output if the job is not interactive or 
becomes a detached interactive job, and can change the job processing option for job 
termination or job suspension. 

The SETJOB command does not take effect until the job terminates or is suspended. If you 
specify more than one SETJOB command, the last one takes precedence. 

Format: 

SETJOB,UJN=uj n,DC=dc,OP=op. 
or 

SETJOB,uj n,dc,op. 

Parameter Description 

UJN=ujn Changes the job's default UJN to ujn. A UJN must be seven or fewer 

characters (alphanumeric and asterisk (*) character). For interactive 
jobs, the default is the user index hash (refer to the ENQUIRE 
command). Otherwise, the default is the UJN specified on the Job 
command. 

DC=dc Specifies the disposition for output upon job termination. The default 

for all jobs is DF. You cannot change the output disposition for an 
interactive job unless the job terminates as a detached interactive job. 

dc Description 

TO Queues output with a wait disposition, 

NO Discards output. 

DF Specifies default output processing. The output disposition 

depends on the job's origin type (refer to File Types in 
section 2), No output is queued for interactive jobs. 

OP=op Specifies the job processing option the system exercises upon detached 

interactive job when it is no longer executing. Not applicable to 
noninteractive jobs. The default is SU. 

op Description 

SU The job remains in a suspended state until recovered or 

timed out (refer to the RECOVER command). 

TJ The system terminates the job. 

Job attributes associated with omitted parameters remain unchanged. 
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SETJSL COMMAND 


The SETJSL command sets the system resource unit (SRU) limit for each subsequent job step 
(refer to SRU Limit Control in section 3). Except for interactive jobs, the default job 
step SRU limit (set during CHARGE or USER command processing) is the smaller of the user 
name and the account validation limits (refer to the LIMITS and ENQUIRE commands). For 
interactive jobs, the default job step limit is 64 SRUs. From an interactive job, you can 
increment your job step SRU limit to complete job step execution as described in the 
following paragraphs. 

Format: 

SETJSL,s. 

Parameter Description 

s Maximum number of SRUs allowed for job step execution. Although the 

default base is decimal, octal values can be specified by a B suffix on 
the value. The value s must be greater than 0. The asterisk (*), 
values greater than 219904 (655400B), and values greater than your 
validated limit set the job step SRU limit at the validation limit. 

If s is greater than your current account block SRU limit (refer to the 
SETASL command in this section for a description of the account block 
SRU limit), both the job step and account block SRU are set to s. Also, 
if s is greater than your validation limit, both SRU limits are set to 
the validation limit. 

A dayfile message is then issued indicating what the new values are for 
the job step SRU limit (JSL) and the account block SRU limit (ASL). 

The system issues an error message when the job step SRU limit is reached. A job step 
within a batch job is then terminated (refer to Exit Processing in section 5). In 
interactive jobs, you can increment the SRU limit after receiving the SRU limit message or 
terminate the job. If the job is suspended because a job step or the job itself exceeded 
its SRU limit, the message 

*SRU LIMIT* 

ENTER S TO CONTINUE OR STOP TO END JOB STEP. 

TYPED AHEAD INPUT MUST BE REENTERED. 

is issued. You can enter one of the following; 

Description 

S Increases the SRU limit by 64 units. Job execution continues. The 

64-unit increment can be changed by your site. 

S,nnnnn Increases the SRU limit by nnnnn decimal units. Job execution continues. 
You can enter octal units by specifying a B after the octal number. 

Increases the SRU limit to your maximum. Job execution continues. 

Terminates the job step. Subsequent commands, if any, are not processed. 

Any Increase to the SRU limit through either S or S,nnnn is in effect only for the current 
job step. When the job step terminates, the account block SRU limit and job step SRU limit 
revert to their original values, set by default or by the SETASL and SETJSL commands, 
respectively. Entering S,* in response to an SRU LIMIT message could cause the interactive 
session in progress to exceed the account block SRU limit set by the SETASL command or by 
default. The system then Issues an SRU LIMIT message after a job step has begun. To remedy 
this situation, use the SETASL command to raise the account block SRU limit above the 
current number of accumulated SRUs for the interactive session. 
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When a limit occurs, any typed ahead input will be discarded since it would be processed as 
a response to the limit message. 


SETPR COMMAND 

The SETPR command decreases the CPU priority of a job. A user job cannot increase its 
priority. 

SETPR,p. 

Parameter Description 

p Specifies the priority, 1 ^ p 700. 

Upon job initiation, a job is assigned the maximum priority allowed for its service class. 
(The Installation defines these priority values.) If a job's CPU priority is lower than 
that of other jobs, the job is assigned control of the CPU only when jobs of a higher 
priority do not need it. 


SETTL COMMAND 

The SETTL command sets the CPU time limit for each subsequent job step. Each user name is 
validated for a maximum job step time limit (refer to the LIMITS and ENQUIRE commands). 

When you do not specify a time limit, the system sets the limit at 64 CPU seconds.t 
Interactive jobs can increment their job step time limit to complete job step execution 
(refer to section 8). 

Format; 

SETTL,t. 

Parameter Description 

t Maximum niunber of CPU seconds allowed for job step execution. Although 

the default base is decimal, octal values can be specified by a B suffix 
on the value. 

t must be greater than 0. The asterisk (*), values greater than 32760 
(77770 b), and values greater than your validated time limit set the job 
step time limit at your validated time limit. 

A dayfile message is then issued indicating what the new value is for 
the time limit. 

To set a time limit for job step execution on one CPU of a dual~processor machine, you must 
include a USECPU command in the job. Otherwise, the time limit is set for the cumulative 
job step execution time on both CPUs. 

The system issues an error message when the job step time limit is reached. A job step 
within a batch job is then terminated (refer to Exit Processing in section 5). In 
interactive jobs, you can increment the time limit after receiving the time limit message or 
terminate job. 


t Your site can change this default. 
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If the job is suspended because a job step exceeded its time limit, the message: 

♦TIME LIMIT* 

ENTER T TO CONTINUE OR STOP TO END JOB STEP. 

TYPED AHEAD INPUT MUST BE REENTERED. 

is Issued and you can enter one of the following: - 

Entry Description 


T Increases the central processor time limit by 64 CPU seconds. Job 

execution continues. The 64 CPU second increment can be changed by your 
site. 

T,nnnnn Increases the central processor time limit by nnnnn decimal seconds. 

Job execution continues. You can enter octal seconds by specifying a B 
after the number. 

T,* Increases the central processor time limit to your maximum. Job 

execution continues. 

Causes the job to go through normal abort procedures (for example, EXIT 
processing which can be useful when using procedure files). 

STOP Terminates the job step. Subsequent commands, if any, are not processed. 

Any increase to the central processor time limit through either T or T,nnnn is in effect 
only for the current job step. When the job step terminates, the central processor time 
limit reverts to its original value, previously set by default or by the SETTL command. 

When a limit occurs, any typed ahead input will be discarded since it would be processed as 
a response to the limit message. 

In the following example, a program exceeds its allocated time limit. The user enters T to 
Increase the time limit and the program then runs to completion. 

List 

00100 PROGRAM T 
00110 DO 6 1=1,2500 
00120 DO 6 J=1,4000 
00130 A=1 
00140 6 CONTINUE 
00150 END 

READY. 

settl,10 

READY. 

run 

♦TIME LIMIT* 

ENTER T TO CONTINUE OR STOP TO END JOB STEP. 

TYPED AHEAD INPUT MUST BE REENTERED. 


SRU 66.835 UNTS. 
RUN COMPLETE. 
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SHELL COMMAND 


The SHELL command enables or disables shell program processing of system commands* 

A shell program Is a user-written program (usually In COMPASS) which redefines the set of 
commands that can be entered by a user. A shell program can: 

• Limit a user to a subset of NOS commands; the shell program can define which NOS 
commands the user can or cannot enter. 

• Redefine the effects of a NOS command. A shell program redefines a particular 
command by defining an alternate command or series of commands to be executed 
whenever the user enters the original command. For example, you could redefine a 
user's ATTACH command to execute both an ATTACH and a LIBBIARY command for the 
specified file, thus making the file a global library. 

• Define user-written commands that are not a part of the standard NOS command set. 

In effect, a shell program creates a user-defined subsystem that can be Imposed on 
application users by user name. To enable a shell program for a user name, you can place 
the SHELL command In the user's prologue. You can also associate a shell program with a 
user name using the MODVAL utility. (MODVAL Is described In the NOS2 Administration 
Handbook.) 

For more Information on how to write a shell program, refer to the NOS Reference Set, 
Volume 4, Program Interface. 

Format: 

SHELL. 

or 

SHELL,spn. 
or 

SHELL,spn,pi,.,.,p7. 

Parameter Description 

spn Specifies the shell program name to be executed. 

Pi Specifies parameters to control the loading and execution of the shell 

program. 

Pi 


E 


A 

L 


Description 

Clears controls If there are errors during the loading of 
the shell program. If you do not specify E and such errors 
occur, your job Is aborted with no EXIT processing. 

Clears controls If the shell program aborts. 

Allows local file loading of the shell program. When 
loading the program from a local file, the program must be 
stored in ABS-type records. (Refer to section 15 for a 
description of record types.) 
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G Allows global library load of the shell program. 

S Allows system library load of the shell program. 

T Specifies that the system monitor commands directly from the 

terminal. 

B Specifies that the system monitor commands outside 

procedures. 

C Specifies that the system monitor commands inside procedures. 

The first format disables shell control. 

The second format, specifying only the shell program name, sets the default for p< as A, 

S, and B. 

The last format specifies the extent of shell program control. To get your shell program 
loaded, you must specify at least one of the parameters L, G, or S. To enable any type of 
command monitoring, you must specify at least one of the parameters T, B, or C. 

Example: 

/shell,rmshelL 
SHELL,RMSHELL. 

/rewind,* 

9 FILES PROCESSED. 

/ascii 

UNAin-HORlZED COMMAND. 

In this example, RMSHELL is a shell program that allows execution of REWIND but not ASCII. 
The SHELL command causes the system to perform a system library load of RMSHELL, to enable 
shell control, to clear controls if the shell program aborts, and to monitor commands 
outside procedures. 

The system passes REWIND,* to RMSHELL for examination. Since it is part of the subset of 
allowed system commands, RMSHELL passes control to the system to process that command 
exactly as it is. However, when the system passes the ASCII command to RMSHELL, an 
UNAUTHORIZED COMMAND message is Issued, and the command is not passed back to the system. 


STIME COMMAND 

The STIME command requests that the accumulated SRD value for the job be Issued to the job's 
dayflle. 

Format: 

STIME. 

Dayfile message format: 

STIME nnnnnn.nnn UNTS. 
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SUBMIT COMMAND 

The SUBMIT coumand places a user—supplied job file Into the input queue as a separate job. 
SUBMIT can reformat the file according to directives within the file. Refer to Job Names in 
section 3 for a description of the names associated with the submitted job. 

Format; 

SUBMIT,Ifn.q.NR.c 

Parameter Description 

Ifn Specifies the name of the file to be submitted to the system for 

processing as a batch job. The first record of the file must be in 
6-bit display code. The default is the job's primary file. 

q Specifies disposition of job output (OUTPUT, PUNCH, PUNCHB, and P8) as 

follows: 

BC or B Use the default processing for local batch jobs to 
dispose of job output at the central site. 

NO or N Discard job output at job termination unless the files 
have been explicitly routed (default value for 
interactive origin jobs). The dayfile is not written to 
file OUTPUT. 

RB=un or Route job output to the remote batch or interactive 
E=un user specified by the user name un. The default for un 

is the user name associated with the submitting job. 

TO Job output (including the dayfile) is queued with a wait 
disposition. 

NR No rewind option; the submit file and the file specified on a 

reformatting directive are not rewound before or after processing. If 
NR is omitted, the files are rewound before, but not after processing. 

c Prefix character used to identify reformatting directives in the file to 

be submitted (Ifn). If omitted, the system assumes c is /. 

The number of deferred batch (LDI, SUBMIT, and ROUTE) jobs that you can have in the system 
concurrently depends on your validation (refer to the LIMITS command in this section). If 
this limit is exceeded, an error message is issued to the dayfile, and the SUBMIT command is 
not processed. 

For SUBMIT to process reformatting directives, the first line of the submit file must be a 
cJOB directive. Each line preceded by a prefix character is recognized as a reformatting 
directive. The prefix character is specified on the SUBMIT command (/ by default). 
Throughout this description, the letter c, preceding a directive, denotes the prefix 
character. Reformatting directives may be Interspersed throughout the submit file as long 
as transparent submit mode is not in effect. Transparent submit mode is selected by the 
cTRANS directive and requires you to observe special rules when inserting subsequent 
directives into the file (refer to description of TRANS and NOTRANS directives). 
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The system does not process reformatting directives unless the first line of the submit file 
contains the cJOB directive. Other directives can follow the cJOB directive (that is, they 
can precede the job and/or USER commands), but the first two commands following the cJOB 
directive must be a Job command and a USER command, respectively. The USER command can be 
Inserted in the form of a cUSER directive. For example, the following sequences of lines 
are both valid: 


Ini 


cJOB 

ln2 


ujn,parameters. 

ln3 

or 

USER,username,password, (or cUSER) 

Ini 


cJOB 

ln2 


cNOSEQ 

ln3 


uj n,parameters. 

In^ 


USER,username,password, (or cUSER) 

ln2. 


and ln4 are optional line numbers. 


You can Include line ntimbers on the submit file and specify which line numbers are to be 
removed during reformatting with the cSEQ and cNOSEQ directives. This is especially useful 
if the submit file contains a BASIC program where line numbers are a requirement of the 
language. If line numbers are included in a submit file, the file must begin with a cJOB 
directive. 


The reformatting directives available are described as follows: 


Directive 

cJOB 


cUSER 


cCHARGE 


Description 

Indicates that the submit file is to be reformatted and selects the 
following default reformatting directives. The default directives 
remain in effect until specified otherwise. 

cNOTRANS (disabled by cTRANS) 

cSEQ (disabled by cNOSEQ) 

cPACK (disabled by cNOPACK) 

The cJOB directive must be the first line of the submit file. If 
omitted, the file is not reformatted. If line numbers are Included in a 
submit file, the file must begin with a cJOB directive. 

Inserts a USER command specifying the user name and family of the 
submitting job. If you specify this directive when you are routing a 
job to a remote mainframe (ST=lid parameter on the Job command), the 
destination mainframe must be a NOS mainframe, the same user name and 
family must be valid on the destination mainframe, and your batch 
passwords must be identical on both mainframes. You can use this 
directive only to create the first USER command in a job. 

Inserts a CHARGE command that is identical to the CHARGE command 
currently in effect for the submitting job. If no CHARGE command is in 
effect for the submitting job, this directive has no effect on the 
SUMIT file. 
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Directive 

cEOR 

cEOF 

cSEQ 

cNOSEQ 

cPACK 

cNOPACK 

cTRANS 


Description 


Indicates that an end-of-record mark is to be placed at this point in 
the submit file during reformatting. 

Indicates that an end—of-file mark is to be placed at this point in 
the submit file during reformatting. 

Indicates that the following lines may be preceded by line numbers and 
requests that they be removed (default value). 

Reverses the effect of the cSEQ directive. No attempt is made to 
remove leading line numbers from subsequent lines. This is especially 
useful when line numbers are required (such as in a BASIC program). 

Requests that all succeeding end-of-record and end-of-file marks be 
removed (default value). This directive applies only to internal EOR 
and EOF marks that currently exist. The cEOR and cEOF reformatting 
directives are not affected. 

Reverses the effect of the cPACK directive. Requests that the system 
not discard (currently existing) succeeding internal end-of-record and 
end-of-file marks. 

Requests transparent submit mode. In transparent submit mode, SUBMIT 
ignores reformatting directives until an EOR or EOF mark is 
encountered. The EOR or EOF mark cannot be a mark to be created by a 
cEOR or cEOF directive. SUBMIT performs the following procedure for 
transparent submit mode processing. 

1. Read cTRANS directive. 

2. Check if the next line is a reformatting directive. If it is not, 
skip steps 3 and 4. 

3. Process reformatting directive. If it is a cNOTRANS directive, 
end transparent submit mode processing. 

4. Return to step 2. 

5. Select transparent submit mode and read lines until an internal 
EOR or EOF mark is encountered. 

6. If the cPACK directive is in effect, remove the EOR or EOF mark. 

7. Return to step 2. 
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Directive 


Description 


cNOTRANS 


cREAD.lfn 


The cTRANS directive is typically used in conjunction with the cREAD 
directive. The cREAD directive copies the contents of an existing 
file into the submit file at the location of the cREAD directive. 
Because the file is read in transparent submit mode, no check for 
reformatting directives is attempted until an internal EOR or EOF is 
encountered. The cREAD directive must follow the cTRANS directive and 
must be located before the first succeeding line that is not a 
reformatting directive. If not, transparent submit mode is selected 
before the cREAD directive is encountered and the cREAD is ignored. 

The cSEQ or cNOSEQ directive in effect before transparent submit mode 
was selected has no effect upon the submit file or the file being read 
(cREAD) while transparent submit mode is in effect. However, the 
cPACK or cKOPACK directive in effect before transparent submit mode 
was selected remains in effect after it is selected. 

Reverses the effect of the cTRANS directive and informs the system 
that the submit file is to be examined on a line-by-line basis. All 
directives encountered in the submit file while the cNOTRANS directive 
is in effect are processed. This directive is initially selected by 
default and remains in effect until a cTRANS directive is encountered 
in the submit file. 

Be careful in placing this directive in the submit file. If 
transparent submit mode is selected, this directive can possibly be 
ignored unless it immediately follows either a cREAD directive or an 
internal EOR or EOF mark. 

Requests that the system read the contents of the specified file, Ifn, 
and Insert that file in place of the cREAD directive in the submit 
file, during reformatting. Reading terminates when an EOF or EOI is 
encountered on Ifn. If the file to be read is not currently local to 
the job, the system automatically attempts a GET and then an ATTACH on 
the file. If Ifn is not specified in the directive, TAPEl is 
assumed. If the file specified cannot be found or the read file is 
busy (direct access files only), the job is terminated. The file 
specified by Ifn in the cREAD directive is automatically rewound 
before the read operation unless the NR parameter is specified on the 
SUBMIT command. In this case, the rewind directive must precede the 
cREAD directive in the submit file if it is desired to rewind file Ifn 
before the read operation begins. The system returns all files 
specified in cREAD directives before completion of the job. 

If the cPACK directive is in effect when the file Ifn is read, all 
internal EOR marks are removed. If the cNOPACK directive is in 
effect, all internal EOR marks are read into the submit file in the 
proper position during reformatting. 
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Directive 


Description 


Each line of that file is also checked for a reformatting directive, 
unless transparent submit mode is in effect when file Ifn is read. 

Any directives contained in the file, except another cREAD, are 
processed. The cREAD directive cannot be nested. In addition, any 
directives in effect before the cREAD directive is processed remain in 
effect for the file being read, unless transparent submit mode is 
selected. Then, only the cPACK or cNOPACK directive remains in effect 
for the file being read. Moreover, only those directives that 
immediately follow an internal EOR in the file being read are 
processed. 

If the file to be read is a binary file, it is recommended that the 
cTRANS directive be used to ensure that binary data is not mistaken 
for a reformatting directive. The cTRANS directive should immediately 
precede the cREAD directive in the submit file, if used. 

cREWIND,lfn Requests that the system rewind file Ifn to the beginning-of- 

Information (BOI). If Ifn is not supplied, TAPEl is assumed. This 
directive is required only if the NR parameter is included in the 
SUBMIT command. Otherwise, file Ifn is automatically rewound. 

This directive is used in conjunction with the cREAD directive. Thus, 
if it is desired to rewind a file before the read operation begins, 
this directive must precede the cREAD directive in the submit file. 

ciEC=C 2 Indicates that the prefix character is to be changed from cj 

(current prefix character) to C 2 (new prefix character). The new 
prefix character code is used to recognize all subsequent reformatting 
directives until further changed. 

Input lines must not exceed 320 6-bit characters. If a line exceeds 320 characters, the 
results are unpredictable. 

If the submitted job contains an invalid USER command, the job entering the SUBMIT command 
is aborted. This constitutes a security conflict (refer to the USER command later in this 
section). The security count for the user name that entered the SUBMIT command is 
decremented. If this results in a security count of zero, the job is immediately terminated 
with no EXIT processing (you are logged out if the job is interactive). For further 
information concerning use of the SUBMIT command from an interactive terminal, refer to 
Volume 2, Guide to System Usage. 

Consult your job's dayfile to determine the cause of any errors that occurred during job 
processing. The dayfile for the submitted job is disposed according to the disposition 
parameter on the SUBMIT command. 

When you submit a batch job from an interactive job, all output is dropped (unless requested 
otherwise by the disposition parameter). This includes the dayfile output. Therefore, make 
provisions within your job to save the contents of the dayfile if a processing error 
occurs. You can do this by including the following commands at the end of the command 
record. 

EXIT. 

DAYFILE,Ifn. 

REPLACE,Ifn. 
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SWtTCH COMMAND 

The SWITCH command sets the sense switches for reference by one of your programs. 

Format: 

SWITCH,switch^,switch 2 , • • • ,switchn,jsn. 

Parameter Description 

switch^ Specifies the switches to be set. You must denote each switch^ by an 
integer in the range of 1 through 6. If you specify 0 for this 
parameter, the system sets all sense switches. 

jsn Specifies the job sequence name (JSN) of the job whose sense switches 

will be changed, jsn is an optional parameter, its default is the 
current job. The system recognizes the jsn parameter by its alphabetic 
characters; therefore, jsn can appear anjrwhere in the parameter list and 
can be omitted without leaving a blank parameter field. 


UPROC COMMAND 

The UPROC command specifies a user prologue, a program the system executes each time you 
start a job. 

Format: 

UPROC,FN=pfile. 
or 

UPROC,pfile. 

Parameter Description 

pfile One of your permanent files that contains the desired prologue. If 
pfcontains more than one procedure, the system executes only■the 
first one. If you omit the FN=pfile parameter or give pfile the value 
of zero, the system will no longer execute a user prologue. 

The system executes your user prologue only after it processes your user validation and 
charge information but before it initiates job recovery processing. Depending on the length 
and nature of your user prologue, you may want to initiate recovery processing before your 
user prologue ends. For example, if your user prologue aborts, the system does not initiate 
^®®®very processing. To do this, place the RBCOVKR command within your user prologue (refer 
to section 8 for the RECOVER command and section 4 for writing procedures). 
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USECPU COMMAND 


The USECPU command specifies which central processor is to be used when more than one is 
available for processing. 

Format: 

USECPU,n. 

Parameter Description 

n Specifies which central processor to use. 

n Description 

0 Use either central processor. 

1 Use CPU 0. 

2 Use CPU 1. 

The USECPU command may be used only when the system is running on a model 72—2x, 73—2x, 
74-2x, 174, 720-2, 730-2, 6500, 6700, 830-2, 865-2, or 875-2. On a model 74-2x or 6700, CPU 
0 is the parallel processor, and CPU 1 is the serial processor. On the other systems, both 
CPUs are serial processors. This command is Ignored on single CPU machines. 


USER COMMAND 

The system uses the parameters on the USER command to determine if you are an authorized 
user, which resources you are validated to use, and the extent (limits) to which you may use 
those resources. 

No commands are allowed between the Job and USER commands in nonlnteractlve jobs. If this 
is attempted, the first command is Interpreted as an invalid USER command, and the submitting 
job is aborted with appropriate messages to the dayfile. The submitted job is dropped. 

Format: 

USER,UN“username,PW“password,FM=familyname. 
or 

USER,username,password,familyname. 

Parameter Description 

username Specifies a one— to seven—character alphanumeric user name. 

password Specifies an alphanumeric password. Its maximum length is seven 

characters; its minimum length is defined by the installation. 

familyname Specifies an optional parameter identifying the familytof permanent file 
devices on which your permanent files reside. Specify a family name 
when the system can access more than one permanent file device family. 

If this is not the first USER command of the job or it is the first USER 
command from a job submitted from another job, you must not specify a 
family name different from the current one unless you are so authorized 
(refer to the LIMITS command). 

tRefer to section 2 for a description of permanent file device families. 
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This comnand also defines controls and validation limits for the job and defines your 
permanent file base. An installation may operate with secondary USER commands either 
enabled or disabled. If the system is a secured system, secondary user commands cannot be 
enabled. Only if secondary USER commands are enabled, may you specify a different permanent 
file catalog or family during job processing by issuing another USER command. The system 
only associates permanent file validation limits with this new user name. The remaining 
validation limits still reflect those of the user name specified at job initiation (refer to 
the LIMITS command earlier in this section). 

On a secured system or on an unsecured system with secondary USER commands enabled, an 
invalid USER command is processed as a security conflict. Your job aborts and your security 
count is decremented. If this results in your security count being set to zero, batch jobs 
will terminate without EXIT processing. At a terminal, you will be immediately logged out 
with no dayfile messages Issued to the terminal. If the security count is not zero, the job 
step is aborted with appropriate messages to the terminal and the dayfile and with EXIT 
processing enabled (unless explicitly disabled). 

On an unsecured system with secondary USER commands disabled, any secondary USER command 
will be invalid and aborts the job. This is not a security conflict and the security count 
is not decremented. 

The password is deleted from the USER command before this command is Issued to the dayfile. 

Normally, the familyname parameter need not be included on the USER command. However, if 
you make a practice of specifying your family name each time you submit a job, you can be 
sure that your job will be processed even if your normal system is not available and your 
permanent file family is moved to a backup system. If, after the first USER command, you do 
not specify a familyname on the USER command, your permanent file family remains the same. 

If you specify the 0 (zero) familyname, your permanent file family becomes the system 
default family. 

Example: 

An installation has two systems, A and B. System B provides backup service for system A. 

The system default family name for system A is AFAM, and the system default family name for 
system B is BEAM. 

During normal operations, system A user CWJONES with password JPWD could enter either of the 
following USER commands. 

USER,CWJONES,JPWD. 

USER,CWJONES,JPWD,AFAM. 

System B user JDSMITH with password SPWD could enter either of the following commands. 
USER,JDSMITH,SPWD. 

USER,JDSMITH,SPWD,BFAM. 

If system A failed, user CWJONES would be required to enter 
USER,CWJONES,JPWD,AFAM. 

to identify his family of permanent file devices. User JDSMITH could enter either of the 
USER commands as before because the default family name would still be valid. 
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Normally, the famllyname parameter need not be Included on the USER command. However, if 
you make a practice of specifying your family name each time you submit a job, you can be 
sure that your job will be processed even if your normal system is not available and your 
permanent file family is moved to a backup system. If, after the first USER command, you do 
not specify a familyname on the USER command, your permanent file family remains the same. 

If you specify the 0 (zero) famllyname, your permanent file family becomes the system 
default family. 

Example: 

An installation has two systems, A and B. System B provides backup service for system A. 

The system default family name for system A is AFAM, and the system default family name for 
system B is BEAM. 

During normal operations, system A user CWJONES with password JPWD could enter either of the 
following USER commands. 

USER, CWJONES,JPWD. 

USER,CWJONES,JPWD,AFAM. 

System B user JDSMITH with password SPWD could enter either of the following commands. 
USER,JDSMITH,SPWD. 

USER, JDSMITH, SPWD, BFAM. 

If system A failed, user CWJONES would be required to enter 
USER,CWJONES,JPWD,AFAM. 

to identify his family of permanent file devices. User JDSMITH could enter either of the 
USER commands as before because the default family name would still be valid. 
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COMMANDS FOR INTERACTIVE JOBS 


8 


There are many system commands that you can use only in Interactive jobs or that were 
designed primarily for interactive use. Unless specified otherwise, these commands cannot 
be used in procedures. This section describes these commands under the following headings! 

• Terminal Control Commands 


ASCII 

LINE 

AUTO 

NORMAL 

BRIEF 

SCREEN 

CSET 

TDU 

EFFECT 

TIMEOUT 

KEY 

TRMDEF 

Subsystem Selection 

Commands 

ACCESS 

FORTRAN 

BASIC 

FTNTS 

BATCH 

NULL 

EXECUTE 



• Interactive Status Commands 

ctD 

ctE 

ctS 

• Job Processing Commands 


APPSW 

LOGIN 

BYE 

LOGOUT 

DIAL 

NOSORT 

EXPLAIN 

RECOVER 

GOODBYE 

RUN 

HELLO 

Secure Login 

HELLO7 

SHOW 

HELP 

TEXT 

HELPME 

WHATJSN 

LIB 

X 

LIST 

XMODEM 


• Primary File Editing Commands 

ALTER 

DELETE 

DUP 

LIST 

MOVE 

READ 

RESEQ 

WRITE 

WRITER 
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TERMINAL CONTROL COMMANDS 


The terminal control commands change the characteristics of the terminal and vary the source 
and format of information given to and received from the system. You can enter these 
commands at any time after you successfully log in. 


ASCII COMMAND 

If you are at an ASCII terminal, this command allows you to use the ASCII 128-character set 
and to place the terminal in ASCII mode. On non-ASCII terminals, this command allows the use 
of up to 128 of the characters defined for the terminal. The ASCII command allows you to 
enter lowercase letters that are interpreted by the system rather than translated to upper¬ 
case as is done in normal mode. 

Format: 

ASCII 

In ASCII mode, characters entered from the terminal are translated into 6/12-bit display 
code. On an ASCII terminal, 6/12-bit display code consists of 95 graphic characters and 33 
control characters (the 128-character set). The standard ASCII graphic 64-character set con¬ 
tains only the first 64 (or 63 depending on an installation option) of these 95 characters. 

In normal mode, you are restricted to these 64 (or 63) characters. Characters of the ASCII 
graphic 64-character set are processed internally as 6-bit display code characters. The 
additional characters that make up the ASCII 128-character set are processed internally as 
12-bit display code characters. Refer to appendix A for further information on display codes 
and character sets. 

The system normally receives all ASCII characters except line feed, carriage return, NUL, 

EOT, DEL, and the logical backspace character. Control characters (line feed, cancel line, 
and backspace) are not received unless in fiHl-ASCII or special editing mode. Commands can 
be entered in either uppercase or lowercase regardless of ASCII mode. 




If a correspondence code terminal is being 
used, you must be in ASCII mode in order to 
use the full correspondence code set. 


You can include this command in a procedure. 
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AUTO COMMAND 


The AUTO command automatically generates five-digit line numbers. 

Format; 

AUTO,nnnnn,iiii 

Parameter Description 

nnnnn Specifies the beginning line number; default value is 00100. 

iiii Specifies the increment value added for each succeeding line number; 

default value is 10. 

To exit from auto mode, you press the cancel line character followed by thus deleting 
the current line. You can also exit from auto mode by entering the termination sequence. 

You can then enter a new command on the next line. 

You can alter the line numbering sequence by deleting the line with the cancel line 
character and then entering a new beginning line nimber. You should exercise caution when 
doing this since the AUTO command is still in effect and continues generating line numbers 
using the original Increment value. Thus, if a line number is generated that already exists 
in the file, the original contents of that line are lost and must be reentered. The 
Increment value cannot be altered unless a new AUTO command is entered. 

In the following example of the AUTO command, the user deletes a line number to change the 
numbering sequence and then deletes another line number in order to place a character in 
column 6. 

READY. 

auto 

00100 program header 
00110 write 1000 


00120 


User 

enters 

cancel 

line 

character 

♦DEL* 

00230 

1000 formatCI5x,'headings') 

User 

enters 

entire 

line. 


00240 

00250 

00260 

write 2000 

2000 formatdSx,' author' ,9x,' title' ,15x. 

User 

enters 

cancel 

line 

character 

♦DEL* 

00260+ 'publisher',6x,'cost') 

User 

completes the 

line. 


00270 

00280 

00290 

stop 

end 

User 

enters 

cancel 

line 

character 


*DEL* 

List 


00100 PROGRAM HEADER 
00110 WRITE 1000 

00230 1000 FORMAT(15X,'HEADINGS') 

00240 WRITE 2000 

00250 2000 FORMAT(15X,'AUrHOR',9X,'TrrLE',15X, 
00260+ 'PUBLISHER',6X,'COST') 

00270 STOP 
00280 END 

READY. 
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BRIEF COMMAND 


The BRIEF conmand suppresses all full and partial headers produced by certain commands (for 
example, LIBEDIT), It also prevents the system from echoing editing changes you make to the 
primary file when using the primary file editing commands described later in this section. 

F ormat: 

BRIEF 

To clear the effect of the BRIEF command, use the NORMAL command. 


CSET COMMAND 

The CSET command sets the character set mode of the terminal. 

Format: 

CSET,mode 

Parameter Description 

mode Specifies terminal character set mode. 

ASCII Selects ASCII mode (ASCII 128-character set). 

NORMAL Selects normal mode (ASCII graphic 63/64-character set). 
The CSET command may also appear in a procedure file. 


note I 


The CSET command sets only the terminal 
character set. If you specify the NORMAL 
parameter, you do not affect auto or brief 
mode. 


EFFECT COMMAND 

The EFFECT command enables or disables the output format effectors supplied by lAF. With 
the lAF effectors disabled, you control terminal output by supplying an appropriate effector 
as the first character of each output line; the system interprets the first character of 
each line as an effector and inhibits printing of the character. 

Format effectors control carriage positioning on output operations. The effectors for 
specific terminal classes are described in the Network Access Method Version 1/Communications 
Control Program Version 3 Terminal Interfaces Reference Manual. This command is valid for 
all terminals connected through NAM. 
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NOTE I 


Control bytes 0001, 0002, 0003, 0005, 0010, 
0013, 0014, 0015, and 0016 should not be 
used with lAF effectors disabled. 

The ? prompt, normally supplied by the 
system, to request input is not displayed 
when format effectors are user-supplied. 


Format: 

EFFECT,mode. 
Parameter 


Description 


node Specifies whether or not lAF automatically supplies format effectors. 

Values that can be entered for mode are as follows: 

Value Description 

SYSTEM Format effectors are supplied by lAF. This is the default 
value. 

USER Format effectors are user-supplied as the first character 
of each output line. 

When format effectors are user-supplied (i.e., EFFECT,USER 
is specified), all format effectors are supported except 
those that specify carriage positioning after output. 
Specifically, the slant (/) and period (.) effectors are 
not supported. 

You can include this command in a procedure. 


KEY COMMAND 

The KEY command maintains key definition files which define the function keys for a CDC 721 
terminal. KEY is used to create, edit, display, or load a definition file. 

The KEY command is valid only for a CDC 721 terminal operating in screen mode. To use this 
command, select the appropriate option from those listed below and enter the command with 
that option. The KEY command provides you with interactive help to assist you in creating, 
editing, or loading the definition file. 

Format: 

KEY,option,filename, 
or 


KEY? 
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Parameter Description 

option Any of the following options. 

Option Description 

HELP Gives a brief description of each option available. The 

filename parameter is Ignored. 

CHECK Checks to see if function key definitions are already 

loaded into the terminal. If not, the definitions in file 
filename are loaded. 

DEFAULT Sets key definitions to the NOS system default keys. The 
filename parameter is Ignored. The default keys are: 

HELP key = HELP 

EDIT key = FSE 

STOP key = CTRL-T followed by carriage return 

DISPLAY Displays the key labels for function keys FI through F16. 

EDIT Initiates creation or editing of a key definition file. 

KEY first searches for a local file by the specified name, 
then for an indirect access permanent file. If filename 
does not exist, it is created. The edited file is saved 
or replaced at completion of editing. 

LOAD Loads key definitions into the terminal from the specified 

file. 

PRINT Creates a local file called KEYPRNT on which the key 

definitions are listed from the specified filename. 

filename The name of the key definition file. Default is KEYDEFS. 

? Lists the options and prompts you for an option and filename. 

The KEY command may appear in a procedure file. 
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UNE COMMAND 


The LINE command specifies that your terminal is to be operated in line (or scrolling) mode, 
as opposed to screen mode. Commands and features affected by the LINE command include 

CATLIST, FSE, screen formatting, and the display of NOS procedure parameters. 

The LINE command also Identifies the terminal model to the system and initiates a search for 
the terminal definition file for that model (unless the CDC 721 terminal was specified; 
characteristics of this terminal are preloaded into the system so that no definition file is 
required). The system uses the following search order in attempting to find the definition 
file: 

• A local file called TERMLIB (created using the TDU utility). 

• An indirect access permanent file called TERMLIB under your user name. 

• An indirect access permanent file called TERMLIB under user name LIBRARY 

(UN=LIBRARY). Your site may maintain a system file containing common terminal 
definitions. 

If TERMLIB is found under your user name or under user name LIBRARY, the system copies the 
terminal definition to a local file called ZZZZTRM for later use by NOS full screen display 
features. The terminal files listed below for the TM parameter are released with the system 
and are always available once you have identified your terminal in a LINE or SCREEN command. 

Format: 

LINE, TM=Tnodel. 
or 

LINE,model. 
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Parameter 


Description 


TM=model Specifies the terminal model. The value specified for model is the 

terminal mnemonic defined in the terminal definition file or the 
terminal mnemonic for one of the following preloaded terminal 
definitions: 

model Description 

721 CDC 721 terminal. 

721V3 CDC 721 terminal version 3. 

722 CDC 722 terminal. 

72230 CDC 722-30 terminal. 

VTIOO DEC VTIOO terminal.'^ 

Z19 Zenith Z19 or Z29 terminal or Heathkit H19 terminal. 

ADM3A Lear Siegler ADM3A terminal.ttt 

ADM5 Lear Siegler ADM5 terminal .ttt 

TV924 TeleVideo 924 terminal. tttttt 

TV950 TeleVideo 950 terminal. tttttt 

TV955 TeleVideo 955 terminal. tttttt 

T4115 Tektronix 4115 terminal .tttt 

3270 IBM 3270 terminal. ttttt 

PCONxx IBM PC using CDC CONNECT, xx is the current level of 
CONNECT. 

If you want your terminal to have the type-ahead capability, append T 
to the model name you are using in the LINE command. Type-ahead 
allows you to press a function key two or more times in quick 
succession, rather than pressing it once and waiting for the system to 
execute it before pressing it a second time. 

If this parameter is omitted, the terminal model is left unchanged. 

You can include this command in a procedure. 


tDEC is a registered trademark of the Digital Equipment Corporation, 
tt Zenith Z19 and Z29 are products of the Zenith Corporation. Heathkit H19 is a product 
of the Heath Corporation. 

ttt Lear Siegler ADM3A and ADM5 are products of the Lear Siegler Corporation, 
tttt Tektronix 4115 is a product of the Tektronix Corporation, 
ttttt IBM 3270 is a product of the IBM Corporation. 

tttttt TeleVideo 924, 950, and 955 are products of TeleVideo Systems, Inc. 
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NORMAL COMMAND 


Ihe NORMAL command reverses the effect of the ASCII; AUTO; BRIEF; CSET,ASCII; and NOSORT 
conuaands on both input and output. The system initially assumes that this command has been 
entered. Normal mode uses the ASCII graphic 63/64—character set. All lowercase letters are 
converted to uppercase (refer to ASCII command) and all command headers are printed (refer 
to BRIEF command). 

Format: 

NORMAL 


SCREEN COMMAND 

The SCREEN command specifies that your terminal is to be operated in screen mode, as opposed 
to line (or scrolling) mode. Commands and features affected by the SCREEN command include 
CATLIST, FSE, screen formatting, and the display of NOS procedure parameters. Also, the 
terminal timeout period is doubled. The SCREEN command also identifies the terminal model 
to the system and initiates a search for the terminal definition file for that model (unless 
the CDC 721 terminal was specified; characteristics of this terminal are preloaded into the 
system so that no definition file is required). The system uses the following search order 
in attempting to find the definition file; 

• A local file called TERMLIB (created using the TDU utility). 

• An indirect access permanent file called TERMLIB under your user name. 

• An Indirect access permanent file called TERMLIB under user name LIBRARY 
(UN=LIBRARY). Your site may maintain a system file containing common terminal 
definitions. 

If TERMLIB is found under your user name or under user name LIBRARY, the system copies the 
terminal definition to a local file called ZZZZTRM for later use by NOS full screen display 
features. The terminal files are always available once you have identified your terminal in 
a SCREEN or LINE command. 

Format: 

SCREEN,TM=model. 
or 

SCREEN,model. 


60459680 M 


8-7 



Parameter 


Description 


TM=model Specifies the terminal model. The value specified for model is the 

terminal mnemonic defined in the terminal definition file or the 
terminal mnemonic for one of the following preloaded terminal 


definitions: 


model 

Description 

721 

CDC 721 terminal. 

721V3 

CDC 721 terminal version 3. 

722 

CDC 722 terminal. 

72230 

CDC 722-30 terminal. 

VTIOO 

DEC VTIOO terminal.t 

Z19 

Zenith Z19 or Z29 terminal or Heathkit H19 terminal.tt 

ADM3A 

Lear Siegler ADM3A terminal.ttt 

ADM5 

Lear Siegler ADM5 terminal.ttt 

T4115 

Tektronix 4115 terminal.tttt 

3270 

IBM 3270 terminal. ttttt 

PCONxx 

IBM PC using CDC CONNECT, xx is the current level of 


CONNECT. 


If you want your terminal to have the type-ahead capability, append T 
to the model name you are using in the SCREEN command. Type-ahead 
allows you to press a function key two or more times in quick 
succession, rather than pressing it once and waiting for the system to 
execute it before pressing it a second time. 

If this parameter is omitted, the terminal model is left unchanged. 

You can Include this command in a procedure. 


tDEC is a registered trademark of the Digital Equipment Corporation. 

tt Zenith Z19 and Z29 are products of the Zenith Corporation. Heathkit H19 is a product of 
the Heath Corporation. 

tttLear Siegler ADM3A and ADM5 are products of the Lear Siegler Corporation, 
ttttTektronix 4115 is a product of the Tektronix Corporation, 
ttttti®! 3270 is a product of the IBM Corporation. 
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TDU COAAMAND 


The TDU command calls an interactive procedure to compile a terminal definition file and 
store the compiled definition (in load capsule form) in a user library. The user library 
can later be accessed by a SCREEN or LINE command to define terminal characteristics to the 
system. 

The user library to receive the load capsule must be a local file. If the library file you 
specify does not exist as a local file, TDU creates it. If you do not specify a library 
file, TDU uses a local file with the name TEEMLIB. If no file TEEMLIB exists, TDU creates 
it. 

Format: 

TDU,I=definition,L=listing,LIB=library,REC=recname,RW=option 

Parameter Description 

I=definition Specifies the terminal definition file. The file must be in 6/12-bit 
display code. For information on how to create a terminal definition 
file, refer to the NOS Version 2 Screen Formatting Reference manual. 

L=listing Specifies the listing file. The listing file contains the list of 
error messages, if any. The default name is OUTPUT. 

LIB=library Specifies the library file to receive the load capsule. The default 
name is TEEMLIB. To be used by the SCREEN and LINE commands, the 
library file must be a local file or an indirect access file called 
TEEMLIB. 

REC=recname Specifies the name of the terminal definition record to be selected 
for processing from the terminal definition file. If an asterisk (*) 
is entered, all records are processed. If EEC is omitted, the current 
record is processed with no regard to the record name. 

RW=optlon Specifies if the terminal definition file and listing file are to be 
rewound before and after processing. 

option Description 

NO or N Files are rewound. 

YES or Y Files are rewound. 

If RW is omitted, the files are rewound. 

The TDU command may appear in a procedure file. 
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TIMEOUT COMMAND 


The TIMEOUT command can change your status from the no-timeout status to the standard 
timeout status. In standard timeout status, you are automatically logged out after the 
installation default of 10 minutes of inactivity. When your terminal is in screen mode, the 
timeout period is doubled (refer to the SCREEN command for more information). If you have a 
no-timeout status (refer to the LIMITS command), the terminal remains connected until you 
log out. The TIMEOUT command changes your status for the session in progress. 

Format; 

TIMEOUT 


TRMDEF COMMAND 

The TRMDEF command changes one or more of the characteristics of your terminal (for example, 
the page length or the page-wait attribute). You can also use terminal definition commands 
(also called network commands) for this purpose. Typically, you would use TRMDEF in a 
prologue to set your terminal attributes for each login—especially if you tend to log in at 
the same type of terminal each time. You would use network commands to make on-the-fly 
changes during a given terminal session. 

The network commands for a NAM/CCP network are in appendix J. The CDCNET Terminal Interface 
Usage manual describes network commands for a NAM/CDCNET network. 

Format: 

TRMDEF,L=lfn,tCi=vi,... ,tCjj=Vjj 

Parameter Description 


L=lfn Specifies an optional file on which the terminal redefinition 

information is written. If Ifn is omitted, file OUTPUT is assumed. 

If another file is specified, the changes are implemented when the 
file is listed or copied to the terminal. 

tCi=Vi Specifies the terminal characteristic to be changed, tc^ is speci¬ 

fied by a two-character mnemonic listed in table J-1 in appendix J. 
The NUL and DEL characters can be specified on the TRMDEF command 
although they cannot be used with the terminal definition commands 
(refer to table J-1). You may not use the mnemonics AR, CH, HN, HS, 
MS, and TM for tc^. 

The new option, v^, is any value in the range given for that termi¬ 
nal characteristic in table J-1. It can be a decimal value, a coded 
value with a special meaning (such as PR for printer), or a single 
character. You can specify multiple values for DL, EB, EL, and XL if 
you separate the values with slants (/), but only as specified in 
appendix J. If the new option is a single character, it can be given 
in any of the following formats. 

Vi Description 

V Any alphanumeric character (a character with a display 

code in the range from 0 through AAg). 
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Parameter 


Description 


vj Description 


$v$ Any character, including special characters, delimited by 
dollar signs (for example, $*$). If the character is a 
dollar sign ($), it must be specified using two dollar 
signs (for example, $$$$). 

vwB Octal value of the 8-bit ASCII code for a character (for 
example, 52B, which would be equivalent to an entry of 
$*$). 


vvD Decimal value of the 8-bit ASCII code for a character (for 
example, 42D, which would be equivalent to an entry of 
$*$). 


Xvv Hexadecimal value of the 8-bit ASCII code for a character 
(for example, X2A, which would be equivalent to an entry 
of $*$). 


I NOTE 


If a numeric value for a single ASCII 
character is specified without a pre- or 
post-radix, the value is assumed to be octal 
unless it contains an 8 or 9. In this case, 
it is translated as decimal. 


Using TRMDEF with NAM/CDCNET 

The CDCNET network defines a larger set of terminal attributes than does the CCP network. 
This gives you a greater degree of control of your terminal and its connections. For 
example, associated with the page wait attribute under CCP are two attributes under CDCNET: 
HOLD_PAGE (HP) and HOLD_PAGE_OVER (HPO). To avail yourself of this added control, you must 
use the CDCNET mnemonics for the attributes when using TRMDEF. The CDCNET Access Guide 
describes the CDCNET mnemonics along with any restrictions for parameter specifications with 
TRMDEF. 

If you do choose to use the CCP mnemonics for terminal attributes even though you are using 
a CDCNET network, the system maps the CCP attributes into the corresponding CDCNET 
attributes. But again, it will not be a one-to-one mapping. The CDCNET Access Guide shows 
how the two sets of attributes interrelate. 
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Examples 


TRMDEF,IN=PT This command changes the input device to a paper tape reader, thus 

allowing you to read data and commands from a tape. It has the 
same effect as the corresponding terminal definition command (that 
is, entry of the control character followed by IN=PT). 

TRMDEF,DL=C20/X03/T0 This command defines three different transparent input delimiters. 

• the transmission of 20 characters 

• the entry of an ETX character code 

• a timeout 

The first delimiter encountered terminates transparent input mode. 

The operating system and the network check the validity of the parameter values you enter. 
The operating system does the preliminary check (syntax and general range checking) and the 
network does the specialized parameter checking. If you specify an invalid parameter value, 
the system informs you and the terminal characteristics in effect before you entered the 
command remain in effect. In general, the system informs you immediately of the error. The 
only case where you do not receive immediate notification of the error is where you have 
specified the L=lfn parameter and the system does not detect the error in its preliminary 
check. However, the network notifies you of the error as soon as you try to actualize the 
changes (copy file Ifn to the terminal). Also, in this case, the system does not report to 
EXIT processing if you entered the command from a procedure. 


SUBSYSTEM SELECTION COMMANDS 


A subsystem creates an environment that facilitates the execution of certain classes of jobs. 
For instance, the FORTRAN subsystem provides a framework in which you can conveniently enter, 
compile, and execute FORTRAN 5 programs. 

The access, execute, BASIC, FORTRAN, FTNTS, and null subsystems greatly restrict your job 
capabilities. Under them, you cannot enter many of the commands described in this manual un¬ 
less you use the X,ccc command format (described later in this section). To have the largest 
set of system commands at your disposal, use the batch subsystem. If you want to use the RUN 
command, however, you must select either the BASIC, execute, FORTRAN, or FTNTS subsystem. 

The following commands select a specific subsystem. You should always be aware of the sub¬ 
system that is currently active. For example, attempting to execute a FORTRAN program while 
operating under the BASIC subsystem causes meaningless diagnostic messages to be Issued. To 
determine which subsystem is currently active, enter the ENQUIRE command. 


r NOTE I 

The subsystem may be automatically selected 
by the system at login If this has been set 
in the validation file (refer to the LIMITS 
command). You can also set the subsystem in 
your prologue with the SET command. 
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A specific subsystem can be associated with an indirect access file so that whenever you 
specify that file as the primary file, the associated subsystem is selected automatically. 

A subsystem flag can be set when you save the file. If you include the SS=subsystem 
parameter on the SAVE command, you can specify any of the valid subsystems. If you enter 
SAVE without SS=subsystem and the file is the primary file, the subsystem flag for the 
current subsystem with the file is set. To save the primary file with no subsystem 
association, you can either enter the null subsystem before saving the file, or enter the 
cotmand: 

SAVE,lfn/SS=NULL 

Automatic subsystem association is made only when the primary file is saved. To associate a 
subsystem with a temporary file other than the primary file, it must be saved with the 
SS=subsystem parameter specified. 


ACCESS COMMAND 

The ACCESS command selects the access subsystem. You cannot enter a RUN command under the 
access subsystem. While in the access subsystem, you can communicate with another 
interactive terminal using the BIAL and WHATJSN commands. You must be authorized to use the 
access subsystem'(refer to LIMITS command). 

Format: 

ACCESS 

The DIAL and WHATJSN commands can be entered only when the access subsystem is active. 


BASIC COMMAND 

The BASIC command selects the BASIC subsystem. A RUN command under the BASIC subsystem uses 
the BASIC compiler. 

Format; 

BASIC,ccc 

Parameter Description 

ccc Specifies a command to be executed after the system executes the BASIC 

command. Any valid command is permitted, as well as all valid 
parameters for that command. 

The following example Illustrates the use of the ccc parameter. 

BASIC,OLD,PRIME 

In this example, the user selects the BASIC subsystem and makes a copy of permanent file 
PRIME the primary file. The file name (PRIME) is a valid parameter with the OLD command. 
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BATCM COMMAND 


The BATCH command selects the batch subsystem. You cannot use the HUN command under the 
batch subsystem. 

Format; 

BATCH,fl 

Parameter Description 

fl Specifies the initial running field length for subsequent job steps. 

Entering this value is equivalent to entering the KFL,fl command 
(refer to section 7). If fl is omitted, 0 is assumed. If you 
implicitly selected the batch subsystem by retrieving an indirect 
access permanent file with the OLD command, the field length is either 
0 or that entered with the last KFL command. 

Unless you have a reeison to do otherwise, choose the batch subsystem for normal job proces¬ 
sing. The batch subsystem allows you to enter essentially all commands allowed in batch 
jobs. Some file management commands and nearly all execution control processing commands are 
available in the other subsystems only through the X,cce command. 

Although you can enter any system command from an interactive job, the output produced by 
several of these commands is formatted for transmission to a line printer (137 characters per 
line). Through use of the L072 command, you can format the output for transmission to a ter¬ 
minal (72 to 160 characters per line) but some data may be lost. Refer to the description of 
the L072 command in section 9. 


EXECUTE COMMAND 

The EXECUTE command selects the execute subsystem. A RUM command under this subsystem 
executes a previously compiled (object code) program. The RUM command must be entered to 
initiate execution. 

Format: 

EXECUTE,ccc 

Parameter Description 

ccc Specifies one command to be executed after the system executes the 

EXECUTE command. Any valid command is permitted, as well as all valid 
parameters for that command. 

In the following example, you select the execute subsystem and make a copy of permanent file 
OBJFILE the primary file. The file name (OBJFILE) is a valid parameter with the OLD command. 

EXECUTE,OLD,OBJFILE 


rNOTE I 

Source language programs cannot be executed 
under the execute subsystem. 
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Use the execute subsystem whenever possible to conserve system resources. Efficiency can be 
achieved when certain programs are used frequently. For example, a source code program 
created under the FORTRAN subsystem must first be compiled before it can be executed (this 
process is automatic; you need only enter the RUN command). The program automatically goes 
through a compilation phase, which produces an executable object code program, and the 
object code program is then executed. Thus, greater efficiency can be achieved by retaining 
the object code program in the permanent file system for later execution under the execute 
subsystem. This can be accomplished by using the following commands (under the FORTRAN 
subsystem): 

RUN,B=lfn 

Causes the object code program to be placed on temporary file Ifn. 

SAVE,lfn/SS=EXECUTE 

Retains file Ifn as a permanent file and sets the execute subsystem flag. 

If this is done, subsequent requests for the file using the OLD command causes the execute 
subsystem to be selected. Entering the RUN command initiates execution of the object code 
program. 


FORTRAN COAAMAND 

The FORTRAN command selects the FORTRAN subsystem. A RUN command under this subsystem uses 
the FORTRAN Version 5 compiler. 

Format: 

FORTRAN,ccc 

Parameter Description 

ccc Specifies a command in addition to the FORTRAN command. Any valid 

command is permitted, as well as all valid parameters for that command. 

The following example illus.trates the use of the ccc parameter. 

FORTRAN,OLD,TAX 

In this example, the user selects the FORTRAN subsystem and makes a copy of permanent file 
TAX the primary file. The file name (TAX) is a valid parameter with the OLD command. 
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FTNTS COMMAND 


The FTNTS command selects the FTNTS subsystem. A RUN command under this subsystem uses the 
FORTRAN Extended Version 4 compiler. 

Format: 

FTNTS ,ccc 

Parameter Description 

ccc Specifies a command in addition to the FTNTS command. Any valid 

command is permitted, as well as all valid.parameters for that command. 

The following example illustrates the use of the ccc parameter. 

FTNTS,OLD,DATAGEN 

In this example, the user selects the FTNTS subsystem and makes a copy of permanent file 
DATAGEN the primary file. The file name (DATAGEN) is a valid parameter with the OLD command. 


NUU COMAAAND 

The NOLL command selects the null subsystem. You cannot use the RON command under this 
subsystem. 


Format: 

NOLL 

This command is entered before saving the primary file if you do not want a specific 
subsystem flag to be associated with the file. Normally, when you save the primary file, an 
internal indicator called the subsystem flag is set to indicate the subsystem currently in 
use. That subsystem is automatically selected in each succeeding request for the file using 
the OLD command. An alternative way of saving the primary file with no subsystem 
association is to specify the SS=NOLL parameter on the SAVE command. No automatic subsystem 
association occurs when saving temporary files other than the primary file. 

If you do not specify a subsystem at login time, the system sets the subsystem specified in 
the validation file during login (refer to the LIMITS Command in section 7). Null is the 
default. 
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INTERAaiVE STATUS COMMANDS 


The system executes Interactive status commands immediately. You may enter them while the 
system is executing another command. The system queues other commands that are typed prior 
to prompts (refer to section 17). 

Format: 

ct X 

Parameter Description 

ct ct is the network control character defined for the terminal (refer to 

the CT command in appendix J). Do not include a space between ct and 
X. We show one here only for clarity. 

X X can be the letter D, E, or S. 

With the exception of the Detach command (ctD), the system generates only a line feed if you 
enter an interactive status command during one of the following states: 

• Text mode 

• Auto mode 

• Input mode (a program is waiting for input) 

• During login 

• During the processing of the interruption or termination sequence 


DETACH COMMAND (ctD) 

The Detach command detaches a terminal job from the terminal. You can detach a job at any 
time during a terminal session. To detach the job during output, first enter the interrup¬ 
tion sequence and then enter the Detach command. Otherwise, ctD alone is sufficient. 

When you detach a job, the following message appears at the terminal: 

JOB DETACHED, JSN=jsn 

All files assigned to the detached job remain assigned to it. Any commands typed ahead, 
before the detachment, are discarded. 

Subsequent to the detachment, the system creates a new terminal session with a new job 
sequence name (JSN), Any commands you enter after the detachment become part of the new 
terminal job. However, if your job is executing a procedure when you detach it, the 
procedure remains a part of the detached job. The system initiates the new job with 
recovery dialogue processing (refer to the RECOVER command in this section). 

The detached job executes until one of the following occurs: 

• No more commands remain. Detaching a job while it is in the IDLE status causes the 
system to reach the end of the command record. 

• A fatal error aborts the job. 
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• The job requests input from the terminal or queues output to the terminal. 

• The job exceeds its time limit or SRU limit. 

• Certain system requests are encountered. 

At this point, the system suspends the detached job unless you specified the OP=TJ parameter 
(terminate job option) on the most recent SETJOB command. The job remains suspended until 
you recover it or until it exceeds its timeout period. You can recover an executing or 
suspended job with the RECOVER command, which is described later in this section. 

You may route terminal output from a detached job to the wait queue. To do this you must 
enter a SETJOB command and an ASSIGN command before detaching the job. The SETJOB command 
should specify DC=TO. The ASSIGN command should be as follows: 

ASSIGN,MS,OUTPUT 

The system limits the number of jobs you can detach (refer to the LIMITS command in 
section 7). 


IMMEDIATE JOB STATUS COMMAND (ctE) 

This command requests detailed job status response. You can enter this command while 
another command is active, and the system processes it immediately. The following output is 
an example of the system's response to a ctE command: 

JSN: AADF SYSTEM; BATCH SRU; 2.095 FILE NAME; SAMPLE2 

STATUS; IDLE 


ABBREVIATED JOB STATUS COMMAND (ctS) 

This command causes the system to give an abbreviated job status response. The system 
issues one of the following responses. 

Response Description 

EXECUTE System is currently processing your command. 

IDLE System is waiting for you to enter a command. 

VAIT System is waiting for system resources to become available. 
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JOB PROCESSING COMMANDS 


The job processing commands allow you to perform a variety of job processing or job-related 
operations. These commands can be entered at any time after login is complete. 


APPSW COMMAND 

The APPSW command allows you to temporarily switch to a secondary (alternate) NAM 
application program. The NAM application you originally logged into is called the primary 
application. The secondary application that you specify on the APPSW command must be one 
that is supported by your site and one that you are validated to use. When you log out of 
the secondary application, your terminal reverts to the primary application. While in the 
secondary application, your current session is suspended. Upon exiting the secondary 
application, your session resumes processing at the point where the APPSW command was 
encountered. 

The job issuing the APPSW command must be an interactive terminal job and must be a NAM 
terminal connection. The APPSW command is invalid for RDF terminals or any origin type 
other than interactive. 

Format: 

APPSW,AP=appl,Z.data 
or 

APPSW,appl,Z.data 

Parameter Description 


appl Specifies one of the following NAM applications: 


appl 

Description 

ITF 

Interactive Transfer Facility 

MCS 

Message Control System 

NETOU 

Network Operator Utility 

NJF 

Network Job Entry Facility 

PLATO 

PLATO-NAM Interface 

PSU 

Printer Support Utility 

RBF 

Remote Batch Facility 

TVF 

Terminal Verification Facility 

TLF 

Tieline Facility 

TAF 

Transaction Facility 

VEIAF 

NOS/VE Interactive Facility 


Z Specifies that any characters following the command terminator are 

to be forwarded to the secondary application as data. 

data Data to be forwarded to the secondary application, data can be up 

to 50 characters long. Any additional characters are truncated. 
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BYE COMMAND 


The BYE command 
disconnects the 

ends your session with 
terminal or places you 

lAF and either logs you out of your host and 
under the control of another NAM application. 

If you are connected to lAF as your secondary application (refer to the APPSW command 
description for more information on secondary applications), entering the BYE command with a 
null application parameter returns your terminal connection to the primary application. 

Format: 



BYE,appl 



Parameter 

Description 

appl 

If lAF is your 
which you wish 
applications: 

primary application, appl specifies an application to 
to be connected. The following are some supported 


appl 

Description 


ITF 

Interactive Transfer Facility. 


MCS 

Message Control System. 


PLATO 

PLATO-NAM Interface. 


RBF 

Remote Batch Facility. 


TAF 

Transaction Facility. 


TVF 

Terminal Verification Facility. 


VEIAF 

NOS/VE Interactive Facility. 


If lAF is your secondary application, you have the following options 
for the appl parameter: 


appl 

Description 


omitted 

If you omit the appl parameter, your terminal is 
logged out of LAF and is returned to the control 
of the primary application. 


ABORT 

If you specify ABORT for appl, an abort status 
message is returned to the primary application, 
and your terminal is disconnected from both the 
primary and secondary applications. 


Any other application name will be ignored, and you will be returned 
to your primary application. 
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If lAF is your primary application and if you select an application that is available and 
that you are validated to use, you are automatically released from lAF control and placed 
under the control of the named application. If you do not select another application, you 
are logged out of the host and the terminal is disconnected. In this case, lAF responds by 
printing: 


UN=username 

JSN=jsn 

Characters=xxxxx 

lAF 

LOGGED OUT. 


LOG OFF 

SRU-S 

KCHS 

CONNECT TIME 


HH.nini.ss. 

s.sss 

HH.mm.ss. 


The following describes the variable items in the logout information: 


Item 


Description 


username 


User name. 


hh.mm.ss. Time of day this command was entered, 

jsn Job sequence name. 


s.sss Measure of system resources used during lAF connection. The SRU is 

a unit of measurement which includes all CPU time, memory usage, and 
I/O activity since login to lAF. 

xxxxxxxx A count of the total number of input and output characters read 

from, or written to, your terminal. 


If you switch applications without disconnecting from the network, your terminal's 
characteristics do not change. 


NOTE 


Ensure that all temporary files to be 
retained are made permanent before issuing 
this command. All files which have not 
been saved are released when the BYE 
command is processed. 


This command can appear in a procedure or in a batch job. If used in this manner, it 
terminates the job. 
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DIAL COMMAND 


The DIAL command sends a one-line message to another terminal user. 

Format: 

DIAL,jsn.sss 

Parameter Description 

3sn Specifies the job sequence name (JSN) of the terminal to receive the 

message. 

sss Specifies the one-line message. 

The receiving terminal displays the message in the format: 

FROM sjsn:sss 

where sjsn is the JSN of the sending job and sss is the message. 

The DIAL command can be entered only if the access subsystem is active. The terminal to 
receive the message can have any subsystem active; it need not be under the access subsystem 
or have access validation. 

You can determine the appropriate jsn by using the WHATJSN connnand. If the terminal 
specified is currently receiving output or has an input request outstanding, the message is 
lost. No further attempt to transmit the message is made. 

EXPLAIN COMAAAND 

The EXPLAIN command retrieves an online version of a GDC manual. 

F ormat: 

EXPLAIN,M=manual 
or 

EXPLAIN,manual 

Parameter Description 

M=manual Specifies the manual you want to retrieve. Your site determines what 

manuals are available to you. If you omit the parameter M=manual, the 
system generates a menu of the EXPLAIN features. 
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GOODBYE COMMAND 


Same as BYE command. 

Format: 

GOODBYE.application 

This command can appear in a procedure or a batch job. If it does, it terminates the job. 


HELLO COMMAND 

The HELLO command logs you out of lAF and switches you to another application or reinitiates 
the login sequence. Your terminal's characteristics do not change. 

Format: 

HELLO.application 

If application is specified or if you are logged into lAF as a secondary application (in 
which case, the application parameter is ignored), this command is the same as the 
BYE,application command. 

If application is not specified, this command logs you out of lAF, as in the BYE command, 
but reinitiates the login sequence. Any temporary files that are to be retained must be 
made permanent before the HELLO command is entered. This form of the command allows a new 
user to log in without first having to establish communications with the network by dialing 
the terminal telephone number. 

This command can appear in a procedure or a batch job. If it does, it terminates the job. 
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HELL07 COMMAND 

The HELL07 command allows you to submit a job that requires terminal input or output to a 
linked SCCPE 2 system and to communicate interactively with an executing SCC^E 2 job. If 
your SCOPE 2 job does not require interactive participation, you can route it to SCOPE 2 
with the EODIE command. 

A job you submit through HELL07 (or the ROUTE command) must be a standard SCOPE 2 job using, 
SCOPE 2 control statements. The job initiates terminal input or output operations by 
specifying CNF=YES on a FILE control statement or macro or by issuing a CONNECT macro for a 
file. 

There are two modes of operation under HELL07: control mode and run mode. In control mode, 
the initial mode on entering HELL07, you are communicating with the HELL07 utility. In 
control mode you can submit a job to SCOPE 2, drop a job, or obtain status information on a 
job. Once you submit a job to SCOPE 2 (by entering a SUBMIT directive), you enter run mode, 
in which you interact directly with your job as it executes on the SCOPE 2 system. You 
remain in run mode until you enter a termination directive. 

The following command calls HELL07 and places the terminal in control mode. 

Format: 

HELL07. 

If your NOS system is attached to a single SCOPE 2 mainframe, HELL07 normally responds with 
a control mode prompt indicating that it is ready to accept a directive. The control mode 
prompt consists of two asterisks (**). The run mode prompt, two dollar signs ($$), is 
discussed under the PROMPT directive below. Both the control mode and run mode prompts are 
followed by a ? prompt. The ? prompt appears at the beginning of the input line. 

In a multimainframe environment, the following prompt may appear after you enter the HELL07 
command. 

MAINFRAME = 

You respond by entering the logical identifier (LID) of the SCOPE 2 system you want to 
access. -If the mainframe you request is not available, the following message appears at the 
terminal. 

MAINFRAME ID NOT IN ID TABLE 

In response to this message you may enter an alternate LID, or you may terminate HELL07 
processing by typing END. 


HELL07 Directives 

Once you have received the control mode prompt (**), you can submit a job, drop a job, 
obtain status information, or temporarily exit from HELL07 using the following HELL07 
directives. The termination directive, *E0F directive, *E0P directive, and *E0S directive 
can be entered only in run mode. All other directives can be entered only in control mode. 
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Directive 


Function 


ub2 

(termination 

directive) 


DROP.J 

or 

DR 


Suspends terminal communications with the SCOPE 2 job. The terminal 
returns to control mode while the job continues to run. You can re¬ 
establish communications with the job (reenter run mode) later using 
the RESUME directive. 

ub2 represents the user break 2 termination sequence recognized by 
your terminal. The actual termination sequence varies with the 
terminal class; most terminal classes use ) or CTRL/T in the 
termination sequence. Refer to Terminating Job Step in Section 16 and 
to the B2 terminal definition command in Appendix J for more 
information on the termination sequence. 

Drops a SCOPE 2 job prior to normal termination. You can then enter a 
status request to determine when drop completion has occurred. 


END or E 


*EOF 

*EOP 

*EOS 

EXIT 


PROMPT,status 


RESUME or R 


Disconnects the terminal from HELLO? and drops any SCOPE 2 job active 
at the time the END directive is issued. 


Inserts an end-of-information designator into terminal input data. 

Inserts an end-of-partition designator into terminal input data. 

Inserts an end-of-section designator into terminal input data. 

Disconnects the terminal from HELLO? but does not drop an active job 
you have submitted to SCOPE 2. This allows you to leave HELLO?, 
execute other commands, eventually return to HELLO?, and resume 
monitoring the executing job. 

Activates or deactivates the automatic run mode prompt which appears 
at the terminal whenever the SCOPE 2 job requests input from the 
terminal. The run mode prompt consists of two dollar signs ($$). 

When the automatic prompt is off, terminal prompts must be supplied by 
the executing SCOPE 2 job. Valid entries for status are as follows. 

Status Description 

ON The automatic pronqjt is activated (default). 

OFF The automatic prompt is deactivated. 

Reestablishes terminal communications with an executing SCOPE 2 job. 
This directive allows you to reenter run mode after having issued a 
termination directive. On reentering run mode, the following message 
appears at your terminal. 

RESUMING ?000 MODE.. 


NOTE 


If you have no SCOPE 2 job active when the 
RESUME directive is issued, the above message 
will be preceded by the warning message, NO 
?000 JOB ACTIVE. The terminal will then 
wait in run mode indefinitely for connected 
file input/output with a SCOPE 2 job output. 
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Directive Function 

STATUS or S Returns status information on the SCOTE 2 job submitted (using the 

SUBMIT directive). The response is of the following form. 

JOBN/IME=jobname USERID=id STATUS=smus 

where: 

jobname Name of last job submitted to SCOPE 2. 
id Your user ID. 

status Indicates the status of the job identified by 

jobname. The following values can be returned for 
status. 

status Description 

INPUT Indicates job waiting for terminal input. 
OUTPUT Indicates job ready for terminal output. 
RUN Indicates job is currently executing. 

STOP Indicates job has aborted. 

SUBMIT,Ifn Submits a local file Ifn to the SCOPE 2 system for execution and 

places the terminal in run mode. The SUBMIT directive must be entered 
with no terminator. HELL07 responds to the directive with this 
message. 

FORWARDING JOB TO MONITOR 

The above message indicates that the job is being validated for 
account codes. When validation is completed, the following message 
appears. 

ENTERING 7000 MODE .. WAIT 

This message Indicates that the logical file name has been routed to 
SCOPE 2 for execution. At this point, you have entered run mode and 
are waiting for the job to be scheduled. When the job is ready for 
input, the run mode prompt ($$) will appear, unless you have disabled 
the automatic prompt using the PROMPT,OFF directive. 

If the connection to the SCCffE 2 system is inoperative, the following 
message is returned in response to the SUBMIT directive. 

7000 INTERACTIVE NOT ENABLED 
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Example: 


The sample job below reads interactive input from a terminal and writes the input 
information to the output file. The saiq>le job is contained in a local file called 
TESTJOB. Following the sample job is an example of an interactive session in which the 
sample job is submitted to SCCS'E 2 through HELLO?. 

Sample Job 


H7J0B,STMFZ,jobcard parameters. 
ACCOUNT,account card parameters. 
FILE (INPUT,CNF^ES) 

FILE (OUrPUT,CNF=YES) 

W NILE, EF=0, TAG. 

COPYR. 

ENDW,TAG. 

d/7/8/9 


Interactive Session 
/hello?. 

MAINFRAME= ? mfz 
** 

? subm it ,te st j ob 

FORWARDING JOB TESTJOB TO MONITOR 
ENT KING 7000 MODE .. WAIT 
** 

? 1 
1 

$$ 

? 222222 
222222 
S$ 

? test abcdefg 
TEST ABCDEFG 
S$ 

7 

*★ 

end 
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HELP COMMAND 


The HELP command generates a menu of the online help features and prompts you to make a 
selection. 

Format: 

HELP 

There are four online help features: 

• A list of all NOS commands, except for compiler calls. 

• Help in entering a command (the HELPME feature). HELPME gives a description of the 
command and its parameters, prompts you for the parameters, and then executes the 
command. 

• Access to an online version of selected CDC manuals (the EXPLAIN feature). 

• A list of the NAM/CCP network commands. 


HELPME COMMAND 

The HELPME command gives a brief description of a command and its parameters, prompts you 
for parameter values, and then executes the command. 

Format: 

HELPME,command 

Parameter Description 


command Specifies a command. You can get a list of commands by using the HELP 

command or by requesting help after entering HELPME. 

The HELPME command is an interactive procedure. You can get help at any time during your 
dialog with HELPME by entering a question mark (or pressing the HELP function key if your 
terminal is in screen mode). For more information about help on procedure calls, refer to 
Requesting Help on Procedure Calls in section 4. 


UB COMMAND 

The LIB command retrieves a copy of an indirect access permanent file from the catalog of 
special user name LIBRARY and makes it the primary file. 

Format: 

LIB,Ifn=pfn/PW=password,PN=packname,R=r,NA,ND,WB 

Parameter Description 

lfn=pfn Specifies the local file name Ifn given the retrieved copy of perma¬ 

nent file pfn. If lfn= is omitted, the local copy is called pfn. 

PW=password Specifies the password needed to retrieve file pfn if one exists. 
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Description 


Parameter 


PN=packname Specifies the auxiliary device on which pfn resides if pfn resides on 
one. 

Specifies the device type of the auxiliary device on which pfn 
resides, only if different from the installation-defined default. 

NA Specifies the no-abort option. LIB processing errors do not terminate 

the job. The job waits for the mounting of disk packs. 

ND Specifies the no-drop option. Local files are not released. 

WB Specifies the wait-if-busy option. The job waits for the mounting of 

disk packs. 

Section 10 contains a detailed description of parameters used on permanent file management 
commands. 

Direct access files can also reside in the catalog of LIBRARY although another command 
method must be used to access these files (described in the following paragraphs). The file 
category is private, semiprivate, or public. The permission mode is that which has been 
granted for private files or specified in the catalog for semiprivate and public files. 

When you enter the LIB command, the system retrieves a copy of the specified indirect access 
permanent file and makes it become the new primary file. For example: 

LIB,ABC75/PW=13479,ND 

Unless you enter the ND parameter, the system releases all files that do not have the 
no-auto-drop status. Certain system scratch files (ZZZZZCO, ZZZZZCl, ZZZZZC2, and ZZZZZLD, 
for example) have this status. You can give a local file this status with the SETFS command. 

In this example, you retrieve a copy of permanent file ABC75 and it becomes the new primary 
file; all local files remain associated with the job. The previous primary file becomes a 
nonprimary temporary file. The LIB command accesses only indirect access permanent files. 

You can enter the following commands to access permanent files in the catalog of LIBRARY 
(differences in command function are described). 

ATTACH,Ifn=pfn/DN=LIBRARY,PW=pas sword,M=m 

This command must be entered to use any direct access permanent files in the catalog 
of LIBRARY. The system does not create a temporary file since all input and output 
operations directly involve the permanent file itself. However, if you wish to 
reference the file by a name other than its permanent file name, you can assign a 
local file name (Ifn) in the command. The primary file name remains unchanged. 

GET,lfn-pfn/DN=LIBRARY,PW=password 

This command retrieves a copy of the specified indirect access permanent file (from 
the catalog of LIBRARY) for use as a temporary file. The primary file remains 
unchanged unless Ifn specifies the name of the current primary file. 

OLD,1fn=pfn/DN=LIBRARY,PW=password 

The function of this command is Identical in all respects to that of the LIB command. 
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You can access from the catalog of LIBRARY only those files that allow alternate user 
access. The system considers all users, except user name LIBRAHY, alternate users. A 
summary of the rules for alternate user access follows: 

• Only chose users with permission can access private files. 

• All users can access semiprivate and public files providing they know the file name, 
password (If one exists for the flle^, type of access (direct or Indirect), and user 
name (LIBRARY). 

The following forms of CATLIST generate the list of accessible files In the catalog of 
LIBRARY. 

CATLIST,LO=F,UN=LIBRARY (full listing) 

CATLIST,UN= LIBRARY (file names only) 


UST COMMAND 

The LIST command lists the contents of a local file. If you want to selectively list lines 
of the primary file, use the alternate form of the command described later In this section 
under Primary File Editing Commands. 

Format: 

LIST,F=lfn 

Parameter Description 

F=lfn Specifies the local file to be listed. The default Is the primary 

file. 

LOGIN COMMAND 

Same as HELLO command. 

Format: 

LOGIN,application 

This command can appear In a procedure or In a batch job. If used In this manner, the 
command terminates the job. 
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LOGOUT COAAMAND 

Same as BYE command. 

Format: 

LOGOUT,application 

This command can appear in a procedure or in a batch job. If used in this manner, the 
command terminates the job. 


NOSORT COMMAND 

The NOSORT command prevents the system from automatically sorting the primary file by 
clearing an internal indicator called the sort flag. Normally, the system sorts the primary 
file, if needed, whenever the current command causes it to read the file. 

Format: 

NOSORT 

This command can be used when making additions or other modifications to the primary file. 
When followed by the NOSORT command, the modifications create a new logical record in the 
primary file. The NOSORT command remains in effect only until the next numbered line of 
source code is entered. This causes the sort flag to be turned on again. 


60459680 D 


8-29 



RECOVER COMMAND 


The RECOVER command recovers detached jobs or interrupted terminal sessions. The RECOVER 
command can also appear in a procedure. 

Format: 

RECOVER,J SN= j sn,OP=T 
or 

RECOVER,jsn,T 
or 


RECOVER 

The parameters are order-independent if you specify the parameters in the keyword=value 
form. Otherwise, the parameters are order-dependent. 

Parameter Description 

JSN=jsn Specifies the job sequence name (JSN) of the detached job. 

OP=T Directs the system to abort recovery processing if you have no 

recoverable jobs. Otherwise, the system engages you in a recovery 
dialog. 

If you specify no parameters and have recoverable jobs, the system displays those jobs and 
their status and prompts you for further recovery directives. 

During job processing, recovery may be necessary in the following cases: 

• Your terminal is disconnected from the system without being logged out. 

• A system malfunction occurs which requires a restart. 

• You want to continue a job you detached. 

The length of time before the system times out the job depends on your validation limits 
(refer to the LIMITS command) and the site—determined default time-out period. 

If you have recoverable jobs in the system, the system automatically displays them after 
login. The system lists four attributes of each recoverable job: its job sequence name 
(JSN), user job name (UJN), current job status, and the time remaining before the system 
forces termination of the job. 
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Example: 


WELCOME TO THE NOS SOFTWARE SYSTEM. 

COPYRIGHT CONTROL DATA 1978, 198X. 

yy/mm/dd. hh.ram.ss. LEOT1 

CDC NETWORK OPERATING SYSTEM.NOS 2 

FAMILY: ,username,password,!af 
JSN: ABNA, NAMIAF 

RECOVERABLE JOB(S) 

JSN UJN STATUS TIMEOUT 

ABMK AJLA SCH ROLLED 

ABMQ AJLA SUSPENDED U MIN. 

ENTER GO TO CONTINUE CURRENT JOB, 

RELIST TO LIST RECOVERABLE JOBS, 

OR DESIRED JSN: go 


READY. 


There are eight status messages 
Status 


that can appear in the STATUS column: 

Description 


EXECUTING 
IDLE 
INITIAL 
I/O ROLLED 
SCP ROLLIN 
SUSPENDED 
T/E ROLLED 
SCH ROLLED 


The job is executing. 

The system has reached the end of the job's command record. 

The job awaits its initial rollin. 

The system is processing interactive input or output from the job. 
The job awaits a rollin for an SCP (system control point) request. 
The job is no longer executing. 

The rolled out job awaits a time or an event. 

The scheduler has rolled out the job. 


If you choose the GO option, the system ends the recovery dialogue. If you choose the RELIST 
option, the system relists the recoverable jobs. If you specify one of the JSNs, you get the 
following display: 


JSN: jsn SYSTEM:subsystem SRU: nnnnnn.nnn FILE NAME: primaryfiLe 
STATUS: message 

CHARACTER SET: charset MODES: modes 
instruction 


The following describes the variable items (in lowercase) in the display: 


item 


Description 


jsn 


subsystem 
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Item 


Description 


The SRUs used by the job. 

The job's primary file. The system suppresses this field if there is 
no primary file. 

Message from executing' job, if present. Otheirwise, the field is blank. 
The interactive character set mode (ASCII or MOBMAL) of the job. 

The prompting mode (BRIEF or PROMPT ON). 

The system's Instruction on job continuation. There are five 
possibilities: 

TEXT MODE. 

OUTPUT AVAILABLE. 

INPUT REQUESTED. 

IDLE. 

JOB IN SYSTEM. 

If the job has output available, the job is started and output continues at the terminal. A 
job waiting for input will not start until you enter the input. 

In general, recovery is designed to provide minimum inconvenience to you with maximum secur¬ 
ity. Certain programs (like the FSE editor) recreate the environment that existed at the 
time of job disruption. However, under certain circimstances, recovery of your information 
cannot be perfect. Here are three examples of such circumstances: 

• In some cases, a few lines of output may be lost when a phone line is disconnected 
because data queued in the network cannot be recaptured by lAF. 

• If a phone line is disconnected when you are entering lines, you can normally expect 
to lose the last few lines you entered. 

• When you are reconnected, terminal characteristics for that terminal session are set 
to the initial values. If a system prologue or user prologue sets terminal 
characteristics, these characteristics are restored during job recovery. If the 
recovered job had altered any of the terminal characteristics, they will not be 
restored automatically. For example, you set the page width to 90 before being 
disconnected. Upon recovery, the page width is set to the initial value for the 
terminal class, not to 90. 


nnnnnn.nnn 
primaryfile 

message 

charset 

modes 

instruction 
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The following is another example of job recovery. 

READY. 

list 

00100 LET A=1 
00110 INPUT B 
00120 FOR 1=1 TO B 
00130 A=A*I 

00140 PRINT I," FACTORIAL IS ";A 
00150 NEXT I 
00160 END 

READY. 

run 

? The user is disconnected before entering data 

and logs in again. 

WELCOME TO THE NOS SOFTWARE SYSTEM. 

COPYRIGHT CONTROL DATA 1978,198X. 

yy/mra/dd. hh.mm.ss. T02A57 
CDC NETWORK OPERATING SYSTEM 
FAMILY: ,usernam^passwrd/iaf 
JSN: AEYT, NAMIAF 


RECOVERABLE JOB(S) 

JSN UJN STATUS TIMEOUT 

ACPJ AJLA SUSPENDED 8 MIN. 

ENTER GO TO CONTINUE CURRENT JOB, 

RELIST TO LIST RECOVERABLE JOBS, 

OR DESIRED JSN: acpj 

JSN: ACPJ SYSTEM: BASIC SRU: 0.047 FILE NAME: RECOVER 

STATUS: 

CHARACTER SET: NORMAL MODES: PROMPT ON 
INPUT REQUESTED. 

? 10 


1 

FACTORIAL 

IS 

1 

2 

FACTORIAL 

IS 

2 

3 

FACTORIAL 

IS 

6 

4 

FACTORIAL 

IS 

24 

5 

FACTORIAL 

IS 

120 

6 

FACTORIAL 

IS 

720 

7 

FACTORIAL 

IS 

5040 

8 

FACTORIAL 

IS 

40320 

9 

FACTORIAL 

IS 

362880 

10 

FACTORIAL 

IS 

3.62880E+6 


READY. 
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Text on this page is deleted. 
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RUN COMMAND 


The RUN command compiles and/or initiates execution of a local file. The compiler used (if 
any) depends on the current subsystem. This command is valid only in the BASIC, FORTRAN. 
FTNTS, and execute subsystems. 

Formats: 

RUN 

RUN,I=lfnj 

RUN,B=lfn 2 or RUN,C=lfn 2 

RUN,I=lfnj,B=lfn 2 or RUN,I=lfnj,C=lfn 2 

RUN,T,qi,q2,...,qjj 

Parameter Description 

Specifies the local file that contains the source program to be 
compiled and executed. 

Ifn 2 Specifies the compiler or assembler output file. File lfn 2 can be 

later executed in the execute subsystem by entering just RUN. 

qi Specifies local files to replace files specified on the PROGRAM 

statement in a FORTRAN 5 program. 

The first format of the command compiles and initiates execution of the primary file. 

The second format of the command compiles and initiates execution of the local file Ifn^ 
if the subsystem and the source program are compatible. 

The third format of the command compiles the primary file and generates a binary file, 
lfn 2 , containing the resulting object code. The object code is not executed. File lfn 2 
can later be executed under the execute subsystem by entering the RUN command. The B and C 
parameter names are interchangeable. 

The fourth format compiles local file Ifni snd generates a binary file, lfn 2 , containing 
the resulting object code. The object code is not executed. File lfn 2 can later be 
executed under the execute subsystem by entering the RUN command. The B and C parameter 
names are Interchangeable. 

The fifth format of the command applies only when running a previously compiled (object 
code) FORTRAN program in the execute subsystem. It allows you to rename local files 
specified in the PROGRAM statement without recompiling the program. Parameters qi through 
In specify new local file names to be used in place of those that currently exist in the 
PROGRAM statement (the parameters are order-dependent and must correspond to those they 
replace). 

The following example illustrates the use of the RUN,T command. Assume a FORTRAN program 
contains the following PROGRAM command. 

PROGRAM TEST (INPUT,OUTPUT,AAA,BBB,TAPE1=AAA,TAPE2=8BB) 

Normally, to execute a program containing this command, you must define local file AAA. 
Local file BBB results from the execution of the program. However, you could change the 
names of local files AAA and BBB without recompiling the program (if the object program 
exists) by using the RUN,T command under the execute subsystem. For example: 

R UN, T, IN PUT, our PUT, CCC,DDD 
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SECURE LOGIN COMMAND t 


The secure login command ensures that your login information goes to the correct host 
software. You can enter this command at any time you are connected to the network. If you 
are already connected to a host when you enter this command, you will be unconditionally 
disconnected and reconnected so that you can proceed with a secure login. This command does 
not disconnect you from the network. 

The secure login command includes a security character that is chosen by your site. The 
procedure you use to enter this security character depends on your terminal type: 

Terminal Type Secure Login Procedure 

Asynchronous Press the BREAK key (or ATTN) and type the security character. 

(except 2741s) 

X.25 PSN terminal Press the BREAK key (or ATTN), type the security character, and 
enter the message transmission signal. 

Mode 4 Clear the screen, enter a carriage return, and clear the screen 

again. Type the security character and press the end-of-block key. 

HASP Type the security character and press the end-of-line key. 

2780 or 3780 Enter /* and the security character from the console or a card 

reader. 

2741 Press the NL key twice and the ATTN key once. Type the security 

character and press the NL key again. 

3270 Clear the screen and enter the program attention 1 key once. Type 

the security character and press the ENTER key. 


SHOW COMMAND 

The SHOW command calls an interactive procedure to display a screen formatting panel. SHOW 
is used for testing purposes. It allows you to display a panel without having to write a 
program that calls the panel. 

Format: 

SHOW,I=panelname 

Parameter Description 

panelname Specifies the name of a compiled panel in user library PANELIB or in 

a global library set. 

Since the SHOW command is an interactive procedure, you can get help information for the 
procedure by entering: 

SHOW? 


tIf your terminal is connected to a CDCNET network, refer to the CDCNET Terminal Interface 
Usage Manual. 


8-36 


60459680 G 


TEXT COMMAND 


The TEXT cotamand selects text mode. Text mode allows direct entry of information (program 
commands, data, or text) into the primary file without specifying line numbers. The system 
Tuterprets commands entered in text mode as text and does not process them directly. 

Format: 

TEXT 

Unless changed during installation, the input line can consist of a mavimiim of 160 
characters. The system appends data to the end of the file. 

To terminate text mode, you should terminate the current input line with a carriage return, 
then enter the interruption sequence or the termination sequence defined for the terminal in 
use or the ETX character followed by a carriage return. (Interruption and termination in 
sequences are discussed in section 16.) 

The system automatically packs the text file to ensure that the data is in one logical 
record. 


I NOTE 


Do not enter a user break to terminate text 
mode until you have received the ENTER TEXT 
MODE message at your terminal. If entered 
before this message, your user break clears 
any unprocessed input, and no data goes into 
the primary file. 


WHATJSN COMMAND 

The WHATJSN command returns the job sequence name (JSN) of the terminal you specify by a 
user name. When several terminals are logged in under the specified user name, a list of 
JSNs is returned. The WHATJSN command can be entered only from the access subsystem. It is 
used in conjunction with the DIAL command to send a message to a user at an interactive 
terminal. 

Format: 

WHATJSN,username 

Parameter Description 

username Specifies the user name of user whose JSN you seek. 
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X command 


The X command forces the system to interpret a command as a batch command. The X command 
does not explicitly change the current subsystem for your job, however. 

Format: 

Xjccc 

Parameter Description 

ccc Any valid batch command. 

This command cannot exceed 80 characters. You must type the entire command but can omit the 
terminator. However, you must enter a terminator after a command if you want to append a 
comment to the command. 

This command is used to enter a batch command that either is invalid in your current 
subsystem or has a different function in that subsystem. 

For example, the command 

X,BASIC 

calls the BASIC compiler Instead of changing your subsystem to BASIC. 


XMODEM COMMAND 

The XMODEM command initiates the transfer of files between NOS and a microcomputer using the 
Christensen protocol. 

Format: 

XMODEM, f n, td, f t, If, sp, ec, f m, cf. 

XMODEM,FN=fn,TD=td,FT=ft,LF=lf,SP=sp,EC=ec,FM=fm,CF=cf. 

Refer to appendix P for more information on the XMODEM command. 


8-38 


60459680 G 



PRIMARY FILE EDITING COMMANDS 

To allow ease of editing primary files, the system provides a line editing capability that 
can be used under any subsystem. The line editing capability allows you to: 

• List lines 

• Correct lines 

• Delete lines 

• Insert lines 

• Copy lines 

The following commands perform the previously indicated editing operations upon the primary 
file: 

Command Function 

ALTER Changes character strings within lines of the primary file. 

DELETE Deletes lines from the primary file. 

Duplicates lines and moves the duplicates to a specific location in 
the primary file. 

LIST Selectively lists lines of the primary file. 

MOVE Moves lines from one location to another in the primary file. 

READ Inserts another file at a specified location in the primary file. 

KESEQ Resequences or adds line numbers to the primary file. 

write Copies lines from the primary file to a specified sequenced file. 

WRITER Copies lines from the primary file to an unsequenced file. 

For other methods of file editing, refer to the EDIT, FSE, and XEDIT commands. 
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PARAMETER FORMAT 


The following subsections describe the specific format of each command. Each command uses 
one or more of the following parameters: 


Parameter 

Name 

Line number 
Line range 


Lines 


Line number 
increment 


String 


Format 


n 

q.. r 


»^2 »• • • >Cn 


z 


/string/ 


Function 

Specifies primary file line number. 

Specifies a set of sequential lines in the 
primary file, q is the beginning line number of 
the range, q may be specified by an asterisk to 
signify that the line range starts at the 
beginning of information (BOI). r represents 
the ending line nximber of the range, r may be 
specified by an asterisk to signify that the 
line range ends at the end of information 
(EOI). To specify a range from BOI to EOI you 
may enter a single asterisk. When using line 
numbers, q must be less than or equal to r. 

Specifies a nonsequential set of lines and line 
ranges separated by commas, cj^ represents a 
line or line range. For example, 

60..90,120,10..40,350 

is a valid entry. Regardless of the order the 
lines or line ranges appear in the parameter, 
the lines are processed in the order they appear 
in the file. 

Generates sequential line numbers 
when inserting text into the file or when 
resequencing is required due to overlapping line 
numbers (refer to Line Number Overlap section), 
z must be in the range of one to 4095 and, when 
omitted, assumes a value of one. 

Specifies a sequence of characters, including 
spaces, delimited by a string delimiter. The 
string delimiter may not consist of the 
following; 

digit , * : letter $ 

) . @ space 

The delimiter chosen may not appear in the 
string. In this subsection, a slant (/) is used 
as the string delimiter. 
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Parameter 

Name 


Format 


Function 


String pair /stringl/string2/ Specifies two different character sequences 

separated by a string delimiter. Stringl 
represents a string as it appears in the file. 
Strlng2 represents how stringl will appear after 
command processing. Stringl and string2 may be 
null strings. A null string contains no 
characters. For example, if stringl were null, 
the string pair would appear as //string2/ . 
Refer to the string parameter description for 
invalid string delimiters. 

File name filename A file name consisting of 1 to 7 characters 

where each character is a letter or digit. 


SUPPRESSING EDITING RESPONSES 

When changing lines within a file, the changed lines are displayed immediately after the 
edit command has been processed. If you do not want the changed lines listed, enter: 

BRIEF 

This conmand will prevent the listing of changed lines. To resume listing changed lines, 
enter; 

hORMAL 

The BRIEF and NORMAL commands are described earlier in this section. 


UNE NUMBBl OVERUP 

Some editing commands require the system to resequence lines of your file. New line numbers 
may overlap existing line numbers. If this occurs, you are asked if the command should be 
executed: 

INSERTED LINES OVERLAP EXISTING LINES, AT 130. 

ENTS? Y TO CONTINUE OR N TO STOP 
o 

If your response is YES, the lines will be inserted and all lines that are overlapped will 
have new line numbers generated in increments of the specified line number increment. If no 
increment is specified, new line numbers are generated in increments of one from the last 
Inserted line. If your response is NO, the command is not executed. 

If your primary file is a BASIC or FORTRAN program, select the corresponding subsystem 
before editing. If you are not under the correct subsystem, the system may not make the 
necessary changes when resequencing lines. Refer to the RESEQ command in section 9 for more 
information on how the system resequences FORTRAN and BASIC programs. 
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INSERTING LINES 

You can add a line to the primary file by prefacing it with a unique line number. 

The following example demonstrates how to Insert a single line into a sequenced file. 


Example: 


List File is listed. 

00100 LET A=1 

00110 LET B=10 

00120 FOR 1=1 TO B 

00130 A=A*I 

00140 PRINT "FACTORIAL ";I,"IS ";A 
00150 fEXT I 
00200 END 


READY. 

00115 Let c=30 Line is entered inserting 

line 115 between 110 and 120 


Li St 

00100 LET A=1 
00110 LET B=10 
00115 LET C=30 
00120 FOR 1=1 TO B 
00130 A=A*I 

00140 PRINT "FACTORIAL ";I,"IS ";A 
00150 NEXT I 
00200 END 


File is listed to show 
corrected version. 


ALTBi COMMAND 

The ALTER command enables you to change character strings within specified lines in the 
primary file. 

Format: 


ALTER,c C 2 ,...,Cn,/stringl/string2/ 

where the lines parameter is optional. If the lines parameter is omitted, the changes 
specified by stringl and strlng2 apply to the entire file. 

When you enter the lines and string pair, only the occurrences of stringl appearing in the 
lines specified by the lines parameter are changed to strlng2. 

When you enter the lines parameter, stringl, and a null string2 (/stringl//), all 
occurrences of stringl appearing in the lines specified in the lines parameter are deleted. 

When you enter the lines parameter, a null stringl, and string2 (//string2/), string2 is 
appended to the lines specified in the lines parameter. 
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To correct a single line in error, you can simply respecify the line number and enter the 
line correctly. 


The following example demonstrates how to change a line by entering the corrected version of 
the line: 

Example: 


List 

00100 LET A=1 
00110 LET B=10 
00120 FOR 1=1 TO B 
00130 A=A*I 

00140 PRINT "FACTORIAL ";I,"IS '•;A 
00150 I«XT I 
00200 END 
RBLDY. 

00110 let b=20 


Li St 

00100 LET A=1 
00110 LET B=20 
00120 FOR 1=1 TO B 
00130 A=A*I 

00140 PRINT "FACTORIAL ";I,"IS ";A 
00150 NEXT I 
0200 END 


File is listed. 


Line is entered changing 
B's value from 10 to 20. 
READY message is not 
given after entry of line. 

File is listed to show 
corrected version. 


When you enter the lines parameter, and stringl and string2 are null (///), the lines 
specified in the lines parameter are listed. 

Example: 


Li St 

00100 LET A=1 File is listed. 

00110 LET B=20 
00120 FOR 1=1 TO B 
00130 A=A*I 

00140 PRINT "FACTORIAL ";I,"IS ";A 
00150 NEXT I 
00200 END 


READY. 

aLter,100..130,/b/c/ 

00110 LET C=20 
00120 FOR 1=1 to C 

READY. 

List 

00100 LET A=1 
00110 LET C=20 
00120 FOR 1=1 TO C 
00130 A=A*I 

00140 PRINT "FACTORIAL ";I,"IS ";A 
00150 NEXT I 
00200 END 


ALTER command is entered, changing 
B to C in lines 100 through 130. 
Changed lines are displayed 
automatically. 

File is listed to show 
corrected version. 
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DS£TE COMMAND 


You can delete specified lines from the primary file using the DELETE command. 
Format: 


DELETEjCj,C 2 Cq,/ string/ 

where either the lines parameter or string parameter must be specified. 

When you enter the lines parameter and do not enter the string parameter, all lines 
specified by the lines parameter are deleted. 


When you enter the string parameter and do not enter the lines parameter, all lines in the 
file containing the specified string are deleted. 

When you enter both the lines parameter and the string parameter, only those lines specified 
by the lines parameter containing the string specified in the string parameter are deleted. 


Example: 

'■■'St File is listed. 

001 (X) LET A=1 

CK)105 LET B=10 

00110 LET C=20 

00120 FOR 1=1 TO C 

00130 A=A*I 

00140 PRINT "FACTORIAL I;I,"IS ";A 
00150 NEXT I 
00200 END 


READY. 

deUte,100..130,/b=10/ 
00105 LET B=10 


READY. 

list 

00100 LET A=1 
00110 LET C=20 
00120 FOR 1=1 TO C 
00130 A=A*I 

00140 PRINT "FACTORIAL I;I,"IS ";A 
00150 NEXT I 
00200 END 


DELETE command is entered, 
deleting all lines from 100 
through 130 which contain 
the string B=10. The deleted 
line is automatically listed. 


File is listed to show 
■corrected version. 
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You can also delete a line by specifying its line number and entering an empty line for it. 

The following example demonstrates how to delete a single line from a sequenced file by 
entering the number of the line to be deleted. 

Example: 

List File is listed. 

00100 LET A=1 
00105 LET B=10 
00110 LET C=20 
00120 FOR 1=1 to C 
00130 A=A*I 

00140 PRINT "FACTORIAL ";I,"IS ";A 
00150 NEXT I 
00200 END 


READY. 
00105 


Li St 

00100 LET A=1 
00110 LET C=20 
00120 FOR 1=1 TO C 
00130 A=A*I 

00140 PRINT "FACTORIAL ";I,"IS ";A 
00150 NEXT I 
00200 END 


DUP COMMAND 

You can duplicate lines and insert them in a specified location in the primary file using 
the DUP command. 

Format: 

DUP,q..r,n,z 

where q..r is a line range and may be specified as a single line number. 

n specifies the line number after which the duplicated the lines are to be inserted. If n 
is not specified, the duplicated lines are inserted at the end of the file. If n is less 
than the first line number in the file, the duplicated lines are inserted at the beginning 
of the file. If n is between two existing line numbers, the duplicated lines are inserted 
between the adjacent lines and incremented by z. If the new line numbers overlap existing 
edit file line nuadsers, line resequencing occurs as described under Line Ntnnber Overlap. 


00105 followed by carriage 
return is entered, deleting 
line 00105. The READY message 
is not given after entry 
of line. 

File is listed to show 
corrected version. 


60459680 D 


8-45 



When BASIC statements containing line numbers and their referenced lines are duplicated, the 
lines and their dxiplicates are kept separate. The duplicate statements containing line 
references reference duplicate lines. Duplicate statements do not reference original 
statements. 


Example: 


list File is listed. 

00100 LET A=1 

00110 LET B=10 

00120 FOR 1=1 TO B 

00130 A=A*I 

00140 PRINT "FACTORIAL ";1,"IS ";A 
00150 NEXT I 
00200 END 


READY. 

dcp,130..150,150,10 
001 60 A=A*1 

00170 PRINT "FACTORIAL ";I,"IS ";A 
00180 NEXT I 


RKDY. 

List 

00100 LET A=1 
00110 LET B=10 
00120 FOR 1=1 TO B 
00130 A=A*I 

00140 PRINT "FACTORIAL ";I,"IS ";A 
00150 NEXT I 
00160 A=A*I 

00170 PRINT "FACTORIAL ";I,"IS ";A 
00180 NEXT I 
0200 END 


DUP comntand is entered, 
duplicating lines 130 through 
150, and inserting the 
duplicates after line 150, 
incrementing subsequent lines 
by 10. Affected lines are 
automatically listed. 


File is listed to show 
corrected version. 


UST COAAMAND 

You can selectively list the lines of the primary file using the LIST command. 

Format: 

LI ST,Cl,.../string/ 

If you specify no parameters, the system lists all lines in the file. To list all of the 
lines in a local file other than the primary file, you can use the alternate format of the 
LIST command, described earlier in this section under Job Processing Commands. 
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The following example illustrates how to use the command. 
Example: 


READY. 

List 

00100 LET A=1 
00105 LET B=10 
00110 LET C=20 
00120 FOR 1=1 TO C 
00130 A=A+1 

00140 PRINT "FACTORIAL ";I, "IS ";A 
00150 NEXT I 
00200 END 

READY. 

List,100..130 

00100 LET A=1 
00105 LET B=10 
00110 LET C=20 
00120 FOR 1=1 TO C 
00130 A=A+1 


READY. 

List,120,100,140..200 

00100 LET A=1 
00120 FOR 1=1 TO C 

00140 PRINT "FACTORIAL ";I, "IS ";A 
00150 NEXT I 
00200 END 

READY. 

List ,/a/ 

00100 LET A=1 
00130 A=A+1 

00140 PRINT "FACTORIAL ";I, "IS ";A 
READY. 

List ,130.. 200,/a/ 

00130 A=A+1 

00140 PRINT "FACTORIAL ";I, "IS ";A 
RKDY. 


List the entire file. 


List a range of lines. 


List a nonsequential set of lines. 


List all lines that contain the 
character A. 


List only those lines in a specified 
range that contain the character A. 
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MOVE COAAMAND 


You may also manipulate lines of the primary file with the use of the MOVE command. The 
MOVE command moves lines from one location in the primary file to another .location. 

Format: 

MOVE,q..r,n,z 

where q..r is the line range parameter and may be specified by a single line nuinber. The 
line number (n) and line number increment (z) parameters are optional. 

The line range parameter specifies the lines to be moved. 

If the n parameter is omitted, the lines are moved to the end of the file and successive 
line numbers are generated in increments of z, if specified, from the last line of the 
primary file. 

If the new line numbers overlap existing line numbers in the primary file, line resequencing 
occurs as described in the Line Number Overlap subsection. 

Example: 

'-ist File is listed. 

00100 LET A=1 
00110 LET B=10 
00120 FOR 1=1 TO B 
00130 A=A*I 

00140 PRINT "FACTORIAL ";I,"IS ";A 
00150 NEXT I 
00200 END 

READY. 

move,100,110,10 

INSERT LINES OVERLAP EXISTING LINES, AT 120. 

ENTER Y TO CONTINUE OR N TO STOP 
? y 

00120 LET A=1 
00130 FOR 1=1 TO B 
00140 A=A*1 

00150 PRINT "FACTORIAL ";I,"IS ";A 
(X}160 NEXT I 

READY. 

List File is listed to show 

00110 LET B=10 corrected version. 

00120 LET A=1 
00130 FOR 1=1 TO B 
00140 A=A*I 

00150 PRINT "FACTORIAL ";I,"IS ";A 
00160 NEXT I 
CX3200 END 


MOVE command is entered, 
moving line 100 and 
inserting it Immediately 
following line 110, 
incrementing subsequent lines 
by 10. Affected lines are 
automatically listed. 


8-48 


60459680 D 



READ COMMAND 


The READ command inserts the lines of a file (read file) at a specific location in the 
primary file. 

Format: 

READ, filename,n,z 

where the line number (n) and line number increment (z) parameters are optional. The 
parameter filename is the name of the file to be inserted. 

When the line number parameter is entered, the contents of the file to be inserted are 
inserted immediately following line n. If the parameter n is a line number that is not in 
the primary file, the read file is inserted after the largest line number that is less than 
n. The line ntmibers of read files are incremented by 1, unless an increment is specified by 
the z parameter. 

If the line nvmber parameter is not entered, the contents of the read file are added to the 
end of the primary file and incremented by z from the last line number of the primary file. 
For sequenced read files, line numbers are added in increments of one, unless otherwise 
specified by the z parameter. A sequenced read file will be resequenced in increments of z 
from the last line number in the primary file. 

Dnsequenced read files will have a five-digit line number added and followed by a blank (in 
the FORTRAN and FTNTS subsystems, the line number is added but not the blank). If a line 
consists of only a line nmber or a line number followed by zero or one blank, the line will 
not be inserted into the primary file. 

If the new line numbers overlap existing lines in the primary file, line resequencing occurs 
as described in the Line Number Overlap subsection. 
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In the BASIC subsystem, when inserting a sequenced read file where no overlapping of line 
numbers occurs, the system handles line references within the read file in the following 
manner. The system automatically updates line references within statements if the referenced 
lines are within the read file. It does not alter line references within statements if the 
lines referenced lie outside of the read file. 

Example: 

List 

CX3100 LET A=1 Primary file is listed. 

00110 LET B=10 
00120 FOR 1=1 TO B 
00130 A=A*I 

00140 PRINT "FACTORIAL ";I,"IS ";A 
00150 NEXT 1 
00200 END 


READY, 
get,skid 

READY. 

read,skid,150,10 

INSERT LINES OVERLAP EXISTING LINES, 
AT 200. 

ENTER Y TO CONTINUE OR N TO STOP 
? y 

00160 LET A=1 
00170 LET B=50 
00180 FOR 1=1 TO B 
00190 A=A*I 

00200 PRINT "FACTORIAL";I,A 
00210 NEXT I 
00220 END 


Read file is made local. 

READ command is entered. With line 
increments of 10, the read file is 
inserted after line 150. 

Y is entered to continue 
command processing. 


Inserted lines are 
automatically listed. 


READY. 

List Primary file is listed to 

00100 LET A=1 show corrected version. 

00110 LET B=10 
00120 FOR 1=1 TO B 
00130 A=A*I 

00140 PRINT "FACTORIAL ";I,"IS ";A 

00150 NEXT I 

00160 LET A=1 

00170 LET B=50 

00180 F(» 1=1 TO B 

00190 A=A*I 

00200 PRINT "FACTORIAL";I,A 
00210 NEXT I 
00220 END 
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Rl^EQ COMMAND 

Refer to the RESEQ comnand in section 9 


WRITE COMMAND 

You can also append lines and line numbers of the primary file to another specified file 
(destination file) by using the WRITE command. 

Format: 

WRITE,filename,cj,C 2 ,....Cq,/ string/ 

where the required parameter filename is the name of a local file. The lines and string 
parameters are optional. 

If the lines parameter is entered and the string parameter is omitted, all lines specified 
by the lines parameter are copied to the destination file. If both the lines parameter and 
string parameter are entered, the lines specified by the lines parameter which contain the 
string specified by the string parameter are copied to the destination file. 

If the string parameter is entered and the lines parameter is omitted, all lines in the 
primary file containing the specified string are copied to the destination file. If both 
the lines and string parameters are omitted, all lines of the primary file are copied to the 
destination file. 

Example: 

Primary file is listed. 

00100 LET A=1 
00110 LET B=10 
00115 LET C=20 
00120 FOR 1=1 TO B 
00130 A=A*1 

001A0 PRINT "FACTORIAL ";I,"IS ";A 
00150 NEXT I 
002(X) END 

READY. 

write/fi Le2,100. . 11 0,120. .* WRITE command is entered, 

writing lines 100 through 
110 and lines 120 through 
200 to destination file 
FILE2. 

READY. 

List,f=fiLe2 FILE2 is listed. 

00100 LET A=1 
00110 LET B=10 
00120 FOR 1=1 TO B 
00130 A=A*I 

OOUO PRINT "FACTORIAL ";I,"IS ";A 
00150 NEXT I 
00200 END 
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WRITEN CX>MMAND 


To copy lines from a sequenced primary file to an unsequenced destination file, enter the 
WRITEN command. The WRITEN command copies specified lines of the primary file to the 
destination file while removing the line numbers; resulting in an unsequenced destination 
file. 


Format: 


WRITEN, fllenamejCj,C2,...,Cn,/string/ 


Example: 

list 

00100 LET A=1 Primary file is listed. 

00110 LET B=10 

00115 LET C=20 

00120 FOR 1=1 TO B 

00130 A=A*I 

00140 PRINT "FACTORIAL ";I,"1S ";A 
00150 NE)CT I 
00200 END 


READY. 

writen^fi Le3,100..110,120..* 
READY. 

list,f=fi le3 

LET A=1 
LET B=10 
FOR 1=1 TO B 

PRINT "FACTORIAL ";I,"IS ";A 

NEXT I 

END 


WRITEN command is entered, 
writing lines 100 through 
110 and lines 120 through 
200 to destination file 
FILES. 

FILES is listed. 


Parameter combinations and functions are the same for the WRITEN and WRITE commands. 
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FILE MANAGEMENT COMMANDS 


9 


The file managemeiih cranmetnds manipulate files assigned to your job. The ccoimands included 
in this category are: 


ASSIGN 

EVICT 

RENAME 

SKIPF 

BKSP 

FCOPY 

REQUEST 

SKIPFB 

CLEAR 

LISTS0 

RESEQ 

SKIPR 

COPY 

LOCK 

RETURN 

SORT 

COPYBF 

L072 

REWIND 

TCOPy 

COPYBR 

MFQUEUE 

ROUTE 

TDUMP 

COPYCF 

NEW 

SCOPY 

UNLOAD 

COPYCR 

OUT 

SECHDR 

UNLOCK 

COPYEI 

OVWRITE 

SETFAL 

VERIFY 

COPYSBF 

PACK 

SETFS 

WRITEF 

COPYX 

PRIMARY 

SKIPEI 

WRITER 


DOCMENT 


The coinm 2 mds in this section position files, copy data frnn one file to another, specify the 
method and format of input or output, sort files, and add corrections. You cam assign your 
files to a specific device type; chamge the file type, identification code, and write 
interlock status; and release them fr^ your job. You can also receive information about 
records in a file or documentation in a file. 

If you use these commands on files structured by CYBER Record Manager (CRM), the output may 
not reflect the CRM logical file structure. The only ccmmamds recommended for copying CRM 
files aure COPY emd COPYEI. 

If a file is not specifically assigned through the use of an ASSIGN, LABEL, or REQUEST 
command, the system assigns the file to availadsle mass storage. 
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ASSIGN COMMAND 

The ASSIGN command directs the system to assign a file to the specified device or device 
type. The following descriptions refer to devices other them magnetic tape. For use of the 
ASSIGN ccmmand with magnetic tape, refer to section 12. 

Format: 

ASSIGN,nn, Ifn, checkpoint, AL=level. 

Parameter Description ‘ 

nn Specifies the device or device type to which the specified file is to 

be assigned; nn may be either the EST ordinal of a peripheral device 
or the device type as defined as follows: 

Type Equipment 

DB 885-42 Disk Storage Subsystem. 

DC 895-1/2 Disk Storage Subsystem. 

DD 834 Disk Storage Subsystem. 

DE Extended memory. 

DF 887 Disk Storage Siibsystem (4K sector) . 

DG 836 Disk Storage Subsystem. 

DH 887 Disk Storage Subsystem (IGK sector). 

DI 844-21 Disk Storage Subsystem (half-track). 

DJ 844-41/44 Disk Storage Subsystem (half-track) . 

DK 844-21 Disk Storage Subsystem (full-track). 

DL 844-41/44 Disk Storage Subsystem (full-track). 

DM 885-11/12 Disk Storage Subsystem (half-track). 

DN 9853 Disk Storage Siibsystem. 

DP Distributive data path to extended memory. 

DQ 885-11/12 Disk Storage Subsystem (full-track). 

DV 819 Disk Storage Subsystem (single-density) . 

DW 819 Disk Storage Subsystem (double-density) . 

EA 5830 Disk Array Subsystem; one 5832 SDD drive used in 

serial mode. 

EB 5830 Disk Array Subsystem; two 5832 SDD drives used in 

parallel mode. 


9-2 


60459680 P 



Parameter 


Description 


yype Equipment 

EC 5830 Disk Array Subsystem; one 5833 SABRE drive used in 

serial mode. 

ED 5830 Disk Array Subsystem; two 5833 SABRE drives: one for 

data emd one for parity. 

EE 5830 Disk Array Subsystem; two 5833 SABRE drives used in 

parallel mode. 

EF 5830 Disk Array Subsystem; three 5833 SABRE drives: two 

for data and one for parity. 

MS Mass storage device. 

NE Null equipment. 

TT^ Interactive terminals. 


tThis device type applies only to interactive origin jobs. 
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Parameter 


Description 


Ifn Specifies the name of the file to be assigned to the specified 

equipment. 

checkpoint Specifies that Ifn is to be used as a checkpoint file (refer to 
section 13). 

checkpoint Meaning 

CB Each dump is VTritten at the BOI of Ifn. 

CK Each dump is written at the previous EOI of Ifn. 

AL=level Specifies the security access level to assign to the file. Unless 

changed by your site, level can be one of the following names: 

LVLO, LVLl, LVL2, LVL3, LVL4, LVL5, LVL6, or LVL7 

The default is the current access level of the job. 

On a secured system, the access level you specify must be valid for 
the job (ENQUIRE,B returns this information) and for the device to 
which you are assigning the file. 

On an unsecured system, the parameter has no effect. The system does, 
however, check for valid parameter specifications. 

When using this command to assign a file for checkpoint dumps on a 
secured system, use the AL=level parameter to assign the file at the 
highest access level valid for the job (ENQUIRE,B returns this 
information). The CKP command aborts the job if the checkpoint file 
is not at this access level. 


Example 1: 

ASSIGN,HS,OUT FUT. 

This command assigns file OUTPUT to mass storage. With this assignment in an Interactive 
job, you can cause output normally printed at your terminal to be written on a mass storage 
fils instead. Here, output means information generated by a program during execution. 
Dayfile messages are still printed at the terminal. Once this assignment is made, output is 
written on the mass storage file OUTPUT until the file is returned or reassigned. 

Example 2: 

ASSIGN,TT,XYZ. 

This command assigns file XYZ to your interactive terminal. The assignment means that input 
that the system would have read from file XYZ is instead solicited by a prompt at the 
terminal and that output that the system would have written on file XTZ is instead displayed 
at the terminal. 

If you have multiple input or output files assigned to your terminal, you may get some 
unpredictable results. 
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Example 3: 


ASSIGN,DI,ABC. 

This command assigns file ABC to an 84A—21 disk drive, if one is available. 

The ASSIGN command can also be used to create or access existing seven- or nine-track 
unlabeled tapes. For a description of the command as it applies to magnetic tape 
assignment, refer to section 12, Tape Management. 


BKSP COMMAND 


The BKSP command directs the system to bypass a specified number of logical records in the 
reverse direction. 

Format: 


BKSP,lfn,n,m. 


Parameter 


Description 


Ifn Specifies the name of the file to be backspaced. 

n Specifies the number of logical records (decimal) to backspace; if 

this parameter is omitted, the system assumes n=l. The maximum for n 
is 262143. 


m Specifies the file mode: C for coded, B for binary. If m is omitted, 

the system assumes the file is in binary mode. 

The BKSP request can be issued at any point in a logical record. If, for example, FILEl 
were positioned within the third record, a 


BKSP,FILEl. 


request would reposition FILEl to the beginning of the third record. The system does not 
backspace past the beginning-of—information (BOI). However, EOF Indicators are considered 
separate records and are included in the record count. 

The BKSP command has no effect on a primary file since that file is rewound before every 
operation. 


9-4 


60459680 C 



BKSPRU COMMAND 


The BRKSPRU command directs the system to bypass a specified number of Physical Record Units 
(PRUs) in the reverse direction. 

Format: 

BKSPRU,lfn,n,m. 

Parameter Description 

Ifn Specifies the name of the file to be backspaced. 

n Specifies the number of PRUs (decimal) to backspace; if this parameter 

is omitted, the system assumes n=l. The maximum for n is 262143. 

m Specifies the file mode: C for coded, B for binary. If m is omitted, 

the system assumes binary mode. 

The BKSPRU command can be issued at any point within a file. The system will not backspace 
the file beyond beginning-of-information (BOI). EOR and EOF indicators are not recognized and 
do not affect the operation; the PRUs in which they occur are bypassed the same as any other 
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BKSPRU COMMAND 


The BRKSPRU command directs the system to bypass a specified number of Physical Record Units 
(PRUs) in the reverse direction. 

Format: 

BKSPRU,lfn,n,m. 

Parameter Description 

Ifn Specifies the name of the file to be backspaced. 

n Specifies the number of PRUs (decimal) to backspace; if this parameter 

is omitted, the system assumes n=l. The maximum for n is 262143. 

m Specifies the file mode: C for coded, B for binary. If m is omitted, 

the system assumes binary mode. 

The BKSPRU command can be issued at any point within a file. The system will not backspace 
the file beyond beginning-of-information (BOI). EOR and EOF indicators are not recognized and 
do not affect the operation; the PRUs in which they occur are bypassed the same as anv other 

Tir>TT 
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CLEAR COMMAND 


The CLEAR consnand releases all files currently assigned to the job. You can also specify 
files that are not to be released. 

Format: 


CLEAR. 


or 

CLEAR,*,Ifni,Ifnj, •- - 

The first format releases all files. The second format releases all files except those 
named. If no files are named, all files assigned to the job are released. 

There are several exceptions. The CLEAR command does not release any files that have 
checkpoint or no-auto-drop status. Certain system scratch files (for exanple, ZZZZZCO, 
ZZZZZCl, ZZZZZC2, and ZZZZZLD) have no-auto-drop status. You can give euiy local file this 
status by using the SETFS command. 

Refer to RETURN commaind in this section for the operations performed on each file type. 


COPY COMMAND 

The COPY commctnd copies data from one file to another if the files are within the remge of 
permissible formats listed in table 9-1. 


NOTE 


When you copy a file with no EOR or EOF file 
marks, the resulting file may have a differ¬ 
ent logical file structure. In particular, 
when copying such a file to tape, the system 
adds an EOR mark to the end of the file. 

Such changes do not affect file content but 
may cause verification errors. 


60459680 C 


9-5 



Table 9-1. Range of Permlaslble Formats for the COPY Ccxmnand 



Output (O-lfn^) 

Input (I-lfn^^) 

Mass 

Storage or 
Terminal 

1 

Tape 

Format 

SI 

Tape 

Format 

S 

Tape 

Format 

L 

Tape 

Format 

F 

Tape 

Format 

LI 

Tape 

Format 

Mass Storage 
or Terminal 

Yes 

Yes 

Yes 

Yes 

Yes 

No 

Yes 

I Tape Format 

Yes 

Yes 

Yes 

Yes 

Yes 

No 

Yes 

SI Tape Format 

Yes 

Yes 

Yes 

Yes 

Yes 

No 

Yes 

S Tape Format 

Yes 

Yes 

Yes 

Yes 

Yes 

No 

Yes 

L Tape Format 

Yes 

Yes 

Yes 

No 

Yes 

No 

Yes 

F Tape Format 

Yes 

Yes 

Yes 

No 

No 

Yes 

Yes 

LI Tape Format 

Yes 

Yes 

Yes 

Yes 

Yes 

No 

Yes 
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Order-dependent format: 

COPY, Ifn]^, lfn 2 , x,c, tc, oopycnt,bsize,charcnt,erlimit,P 2 P 2 - - -Pn, lfn 3 ,ns 
Order-independent format: 

COPY, Islfn^^,0=lfn2, V=x,M=c,TC=tc,N=oopycnt,BS=bsize, CC=charcnt,EL=erlimit, 

PO=piP2. . .Pn,I.=lfn3,NS=ns. 

The parameters can appear in order-dependent format, order-independent format, or a 
combination of both. If order-dependent and order-independent pareuneters are mixed in one 
COPY commemd, the order-dependent parameters must appear in their proper position. All 
parameters are optional. However, the specification of certain pcurameters precludes the 
application of others. A nonapplicable parameter may be ignored or it may be invalid. This 
is stated in the individual descriptions of the parameters. 

Parameter Description Default 

I=lfnj^ Specifies the name of the file to be copied. INPUT 

0=lfn2 Specifies the name of the file receiving the copy. ODTPOT 

V=x If the X parameter (1 to 7 alphanumeric No verify 

characters) is present, both files are rewound, 
copied, rewound, verified, and rewound. The x 
parameter must not be zero. 

M=c Specifies whether the input and output files are 

coded files. 


£ Description 

Cl Coded mode is set on input only. Binary 

C2 Coded mode is set on output only. 

X Coded mode is set on both input 

and output. The value x is any alpha¬ 
numeric, 1- to 7-character string. 


TC=tc 


This parcuneter applies only to S and L format 
tapes. If coded mode is set on an SI tape, 
the system alborts the job. For other formats, 
the system ignores the mode setting. 

Specifies the termination condition for copy- Copy to double 

ing used in conjvinction with N=copycnt. The EOF (TC=D or 

termination condition can be specified as TC=EOD) 

follows: 


tc Description 

F or The N keyword specifies the number 
EOF of files to copy. 


I or Copy to the end of information. The 
EOI N keyword is ignored. 
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Parameter 


N=copycait 

BSsbsize 


CC=charcnt 


EL=erlimit 


Description 

tc Description 

D or The N keyword is the number of double 
EOD EOFs to copy to. If N > 1 is speci¬ 
fied together with this TC value, and 
verify is also selected, the files are 
verified only to the first enpty file 
(COPY calls VERIFY with N=0 parameter) . 

Specifies the copy count used with the copy termi¬ 
nation condition specified by the parameter TC=tc. 

Specifies the maociimmt block size (in central 
memory words) which specifies S or L tape PRD size. 
This applies only when copying to or from S and 
Xi tapes. It cannot be specified with the 
CC=charcnt parameter. 

Specifies the maximum nuunber of characters in 
an S or L tape block. This parameter cam be 
specified only when copying to or from S and L 
tapes. The PRU size auid unused bit count are 
calculated frcan the character count. However, 
the unused bit count is used only when writing a 
full block to an S or L output tape during a copy 
from mass storage, I, LI, or SI format tape. The 
charcnt value should be a multiple of 10. If it 
is not, the characters that exceed the charcnt 
value in the last word of the record are discarded 
when writing an S or L format tape. This parameter 
Ceuinot be specified with the BSsbsize parameter. 

Specifies the number of nonfatal errors allowed 
before edjort. This includes both parity errors 
and block-too large errors which are returned by 
the tape subsystem after coirpleting recovery- 
procedures . If EL=D is specified, unlimited error 
processing is allowed. Error recovery is supported 
on mass storage and on all tape formats but is not 
supported on a terminal or on unit record equipment. 
In the latter cases, any error aborts the job. 


Default 


1 


If CC=charcnt 
is not specified, 
lOOOg for S tape 
copy and 2000g 
for L tape copy. 

Not used (the 
PRU size is 
specified by 
the BS=bsize 
parameter) 


0 (zero) 
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Parameter 


Description 

P 0 =piP 2 ...Pn One or more of the following processing options: 

E Input blocks with parity errors or 
block-too-large errors are processed 
(copied). 

D Any noise blocks generated by a copy 
from mass storage, I format tape, LI 
format type, or SI format tape to an 
S or L format tape are deleted. This 
pcurameter cannot be specified on any 
other type of copy. 


R Allows record splitting during a copy 
frcrni mass storage, I format, LI 
format, or SI format to S or L for¬ 
mat tape. This parameter Ccuonot be 
specified on any other type of copy. 

M Copy files according to the copy 
teimination condition specified by 
the keyword TC, eliminating each 
EOF on output. This option is 
primarily for use with IcUseled S 
and L output tapes since it 
eliminates the conflict of the 
double meaning of a tape mark on 
these formats (the tape mark on 
these formats serves as both an EOF 
cuid label group delimiter). 

L=lfn 3 Specifies the name of an alternate file to 

receive parity error messages when extended 
error processing is in effect (nonzero EL 
specified), in which case, file name lfn 3 
must not be the same as Ifn^ or lfn 2 . 

NS=ns Noise size. Any input block containing 

fewer than ns characters is considered to 
be noise ^uld is discarded. This parameter 
is valid for input tapes in S, L, or F 
format. The meucimum value that cam be 
specified for ns is 41. If NS=0 is speci¬ 
fied, the default value of 18 is used. 

Exan^le: 


Default 


Error blocks 
are skipped. 


For S or L bi¬ 
nary tapes, 
noise blocks 
are padded to 
noise size with 
binary zeros; 
for coded mode, 
they are padded 
with blanks. 

Record splitting 
is not allowed. 


Copy files 
according to 
specification 
of the copy 
termination (TC), 
writing an EOF 
after each file 
on output. 


ODTPDT 


The following COPY command combines order-dependent and order-independent parameters. 


COPY,FILEl, FILE2,VERIFY,CODED,EOF,6,L=MYODT,PO=E,EL=10. 

FILEl is the input file, and FIIjE 2 the output file. Six coded files are copied and 
verified, to 10 nonfatal errors are allowed, and the bad data is copied with informative 
error messages written to the file MYOOT. 
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The COPY command begins a copying operation at the current position of both files vinless the 
verify option is specified. If verification is specified, both files are rewound before the 
copying begins and rewound, verified, and rewound again after the copying is completed. 

This verification may not be mecuaingful if the logical structure of the two files is 
incoiqpatible. 


COPY TERMINATION 

Copying continues until the termination condition for copying is met or EOI is encountered 
The termination condition Cein be a file count, a double EOF count, or EOI. If the copying 
is terminated by a double EOF (for TC=EOD), the second EOF is detected on Ifn^, but is not 
transferred to lfn 2 . If Ifn 2 ^=lfn 2 , the named file is read until the termination condition 
is satisfied or EOI is encountered. 

If the copying conmand specifies a file count, TC=EOF, and EOI is encountered on the input 
file before the file count is satisfied, an additional EOF is written on the output file 
only if data or records have been treuisferred since the previous EOF was written (or since 
the beginning of the copying if no EOFs have been encountered) . 


BLOCK SIZES 

Both li euid F tapes may require additional field length to accommodate their maximum block 
size. The maximum block size for an L tape copy is specified either by the BSsbsize 
parameter (or its default) , or it is calculated from the CC=charcnt. The maximum block size 
for an F tape is determined by the maximum frame or character count specified when the file 
was assigned. The more accurate the selection of these values which determine block size, 
the less are the requirements for field length, CPU time, and I/O time. 


PROCESSING OPTIONS 

The PO=D option specifies noise block processing, and the PO=R option specifies record 
splitting for copies from mass storage, I format, LI format, or SI format to S or L format 
tapes. Due to the incoo^atibilities Isetween the logical structure of the input and output 
files, records may be encountered on the input file that are too small or too large to be 
copied directly to the S or L output tape. If the output file block size is less than noise 
block size, it is deleted if PO=D is specified. If PO=D is not specified, the block size is 
rounded to the word multiple of noise size with binary zero fill for a binary S or L tape or 
with blank fill for a coded S or L tape. Empty records on the input file are skipped since 
they cannot exist on an S or L tape. If PO=R is specified and an input file record length 
exceeds the S or L tape meocimum block size (the PRU size as specified by BS=bsize or its 
default, or by CC=charcnt), it is split into multiple blocks. 

The PO=M option makes it possible to copy a multifile file to a ledseled S or L format tape 
without writing the EOF tape marks. This avoids the conflict of a tape mark serving the 
doiible purpose of defining £ui EOF and delimiting a label group on S and L format tapes. 

This is in keeping with the tendency in the computer industry to define a tape mark only as 
a label delimiter. 

The EL=erlimit and PO=E parameters provide extended error processing. 
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COPYBF COMMAND 

The COPYBF ccxnmand copies a specified number of files frcm one multifile file to another. 


NOTE 


The COPYBF coonnand is not recommended for use 
with S, L, or F format tapes because it does 
not have the data specification parameters 
needed to acconmodate the variety of data 
formats possible with those tape formats. 

For S, Ii, or F format tape copying 
operations, issue a COPY ccmmand with the 
appropriate parameter specifications. 


When you copy a file with no EOR or EOF file marks, the resulting file may have a different 
logical file structure. In particular, when copying such a file to tape, the system adds an 
EOR mark to the end of the file. Such changes do not affect file content but may cause 
verification errors. 


Format: 


COPYBF,Ifn^,Ifn2,n,c. 


Parameter 


Description 


Ifn^ Specifies the name of the file to copy. If this parameter is anitted, 

file INPUT is assumed. 

Ifn 2 Specifies the name of the file to receive the copy. If this pareuneter 

is emitted, file OUTPUT is assumed. 


n Specifies number of files (decimal) on Ifnj^ to copy. If this 

parameter is omitted, 1 is assumed. 

c Indicates that the copying to or from an S or L format tape should be 

performed in coded rather than binary mode. C is a one- to seven- 
character string. If coded mode is set on an SI tape, the system 
aborts the job. The system ignores this parameter for mass storage 
files ouid I, LI, and F format tape files. 


The copying begins at the current position of Ifn^^. If lfni=lfn 2 , the file is read until 
the file count is satisfied or EOI is encountered. 


If EOI is encountered on Ifnj^ before the file count is satisfied, an additional EOF is 
generated on lfn 2 only if data or records have been transferred since the previous EOF was 
written (or since the beginning of copy if no EOPs have been encountered) . 
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COPYBR COMMAND 

The COPYBR ccanmand copies a specified number of records frcMi one file to another. 


NOTE 


The COPYBR commcmid is not recommended for use 
with S, h, or F format tapes because it does 
not have the data specification parameters 
needed to accommodate the variety of data 
formats possible with those tape formats. 

For an S, L, or F format tape copying 
operation, issue a COPY command with the 
appropriate parameter specifications. 


When you copy a file with no EOR or EOF file marks, the resulting file may have a different 
logical file structure. In paxticular, when copying such a file to tape, the system adds an 
EOR mark to the end of the file. Such chcuiges do not affect file content but may cause 
verification errors. 


Format: 


COPYBR, Ifn3^, If n2, n, c. 


Parameter 


Description 


Ifn^ Specifies the name of the file to copy. If this parameter is omitted, 

file INPtTT is assumed. 

Ifn 2 Specifies the name of the file to receive the copy. If this parameter 

is omitted, file OUTPUT is assumed. 


n Specifies the number of records (decimal) to copy; if this parameter 

is (knitted, 1 is assumed. 

c Indicates that the copying to or from an S or L format tape should be 

performed in coded rather tham binary mode. The value C is an alpha¬ 
numeric one- to seven-character string. If coded mode is set on an SI 
tape, the system cd>orts the job. The system ignores the mode setting 
for other formats. 


The copying begins at the current position of Ifnj^. EOF indicators are considered separate 
records and are included in the record count. If lfnj^=lfn 2 , the file is read until the 
record count is satisfied or EOI is encountered. 

If EOI is encountered on Ifnj^ before the record count is satisfied, an additional EOR is 
written on lfn 2 only if data has been transferred since the previous EOR or EOF was written 
(or since the beginning of the copy if no EORs or EOFs have been encountered) . 


9-12 


60459680 C 




COPYCF COMMAND 


The COPYCF comnand copies a specified number of coded files from one file to another, A 
coded file is defined as a file containing lines of 500 characters or less, each terminated 
by a zero byte (12 zero bits in the lowest byte of a word). 

I note" 


The COPYCF command is not recommended for 
use with S, L, or F format tapes because it 
does not have the data specification 
parameters needed to accommodate the 
variety of data formats possible with those 
tape formats. For an S, L, or F format 
tape copying operation, issue a COPY 
command with the appropriate parameter 
specifications. 

The COPYCF command cannot copy SI format 
tapes. If coded mode is set for an SI 
tape, the system terminates the job. The 
TCOPY command converts SI coded tape files. 


When you copy a file with no FOR or EOF file marks, the resulting file may have a different 
logical file structure. In particular, when copying such a file to tape, the system adds an 
EOR mark to the end of the file. Such changes do not affect file content buy may cause 
verification errors. 

Format: 


COPYCF,Ifnj,Ifn 2 ,n,fchar,lchar,na. 
Parameter 


Ifn^ 

lfn2 


fchart 


1chart 


na 


Description 


Specifies the name of the file to copy, 
file INPUT is assumed. 


If this parameter is omitted, 


Specifies the name of the file to receive the copy. If this parameter 
is omitted, file OUTPUT is assumed. 


Specifies the number of files (decimal) to copy, 
omitted, 1 is assumed. 


If this parameter is 


Specifies the first character position of each line to copy for 6-bit 
characters. If this parameter is omitted, the copying begins at 
character position 1. 

Specifies the last character position of each line to copy for 6-bit 
characters. Ichar must be greater than or equal to fchar. If this 
parameter is omitted, the copying ends at character position 136. 

Specifies that the job step should not abort when a line terminator 
does not appear before an EOR. na can be any alphanumeric, one- to 
seven-character string. 


tSince many characters in 6/12-bit display code require 12 bits rather than 6, this param¬ 
eter may produce unforeseen results when copying a file containing 6/12-bit display code 
data. Refer to appendix A for a description of character set codes. 
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The copying begins at the current position of Ifnj^. If lfni=lfn 2 j the file is read 
until the file count is satisfied or EOI is encountered. If EOI is encountered before the 
file count is satisfied, an EOF is written on lfn 2 , and the operation terminates. If a 
line is encountered that has more than Ichar characters, the excess characters are truncated. 

The COPYCF command writes lines with an even number of characters. If an input line has an 
odd character count and the last character is a blank not immediately preceded by a colon, 
the last character is removed. If an input line has an odd character count and the last 
character is not a blank or is a blank immediately preceded by a colon, an additional 
trailing blank is appended. 

If the COPYCF command attempts to copy a line longer than 500 6-bit characters, the line is 
truncated, and an informative message is Issued to the dayfile after the copying completes. 

If the last line of a record does not have an end-of-line terminator, the system issues a 
dayfile message. If the na parameter is not specified, the job step then aborts. 
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COPYCR COMMAND 


The COPYCR comnand copies a specified number of coded records from one file to another. A 
coded record contains lines of 500 characters or less, each terminated by a zero byte (12 
zero bits in the lowest byte of a word). 


NOTE 


The COPYCR command is not recommended for 
use with S, L, or F format tapes because it 
does not have the data specification 
parameters needed to accommodate the 
variety of data formats possible with those 
tape formats. For an S, L, or F format 
tape copying operation, issue a COPY 
command with the appropriate parameter 
specifications. 

The COPYCR command cannot copy SI format 
tapes. If coded mode is set for an SI 
tape, the system terminates the job. The 
TCOPY command converts SI coded tape files. 


When you copy a file with no EOR or EOF file marks, the resulting file may have a different 
logical file structure. In particular, when copying such a file to tape, the system adds an 
EOR mark to the end of the file. Such changes do not affect file content but may cause 
verification errors. 

Format: 


CO PYCR,lfn 2 ,lfn 2 ,n,f char,1char,na. 


Parameter 


Description 


Ifnj Specifies the name of the file to copy. If this parameter is omitted, 

file INPUT is assumed. 


Ifn 2 Specifies the name of the file to receive the copy. If this parameter 

is omitted, file OUTPUT is assumed. 


n Specifies the number of records (decimal) to copy. If this parameter 

is omitted, 1 is assumed. 

fchart Specifies the first character position of each line to copy for 6-bit 

characters. If this parameter is omitted, the copying begins at 
character position 1. 

Ichart Last character position of each line to copy for 6-bit characters. 

Ichar must be greater than or equal to fchar. If this parameter is 
omitted, the copying ends at character position 136. 


na Specifies that the job step should not abort if a line terminator does 

not appear before an EOR. The parameter na can be any alphanumeric, 
one- to seven-character string. 


"^Since many characters in the 6/12-bit display code require 12 bits rather than 6, this 
parameter may produce unforeseen results when copying a file containing 6/12-bit display 
code data. Refer to appendix A for a description of character set codes. 
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The copying begins at the current position of Ifnj. If lfni=lfn 2 > the file is read 
until the record count is satisfied or EOI is encountered. EOF indicators are considered 
separate records and are Included in the record count. If the EOI is encountered before the 
record count is satisfied, an EOR is written on lfn 2 , and the operation terminates. The 
COPYCR command is processed in exactly the same manner as the COPYCF command except that n 
specifies the number of records rather than the number of files. 

If the COPYCR command attempts to copy a line longer than 500 6-bit characters, the line is 
truncated, and an informative message is Issued to the dayfile after the copying completes. 

If the last line of a record does not have an end-of-line terminator, the system Issues a 
dayfile message. If the na parameter is not specified, the job step then aborts. 

COPYEI COMMAND 

The COPYEI command copies one file to another. The copying begins at the current position 
of the file and continues until the EOI is encountered. The EOI is not defined for certain 
tape formats (refer to table 2-1). 


NOTE 


The COPYEI command is not recommended for use 
with S, L, or F format tapes because it does not 
have the data specification parameters needed to 
accommodate the variety of data formats possible 
with those tape formats. For an S, L, or F for¬ 
mat tape copying operation, issue a COPY command 
with the appropriate parameter specifications. 

When you copy a file with no EOR or EOF file 
marks, the resulting file may have a different 
logical file structure. In particular, when 
copying such a file to tape, the system adds an 
EOR mark to the end of the file. Such changes 
do not affect file content but may cause 
verification errors. 


Format: 


COPYEI, If nj^. If n2,x,c. 


Parameter 


Description 


Ifn^ Specifies the name of the file to copy. If this parameter is omitted, 

file INPUT is assumed. 

Ifn 2 Specifies the name of the file to receive the copy. If this parameter 

is omitted, file OUTPUT is assumed. 


X Specifies that both files are rewound before the copying, and rewound, 

verified, and rewound again after the copying is complete, x can be 
any alphanumeric, one- to seven-character string. 

c Indicates that the copying to or from an S or L format tape should be 

performed in coded rather than binary mode. If coded mode is set on 
an SI tape, the system aborts the job. For other formats, the system 
ignores the mode setting, c can be any alphanumeric, one- to seven- 
character string. 


If lfn]^=lfn 2 , the file is read until EOI is encountered. 
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COPYSBF COMMAND 


The COPYSBF command copies a file and inserts a space before the first character of each 
line of the file. For a file without printer control characters, insert spaces in the file 
with this command before routing the file to a printer. The system assumes that a file 
routed to a printer has a printer control character as the first character of each line. 

You might get undesirable results if you do not ensure that a printer control character 
appears first. Refer to appendix H for more Information on printer control characters. 


NOTE 1 

The COPYSBF command is not recommended for 
use with S, L, or F format tapes because it 
does not have the data specification 
parameters needed to accommodate the 
variety of data formats possible with those 
tape formats. For an S, L, or F format 
tape copying operation, issue a COPY 
command with the appropriate parameter 
specifications. 

When you copy a file with no EOR or EOF 
file marks, the resulting file may have a 
different logical file structure. In 
particular, when copying such a file to 
tape, the system adds an EOR mark to the 
end of the file. Such changes do not 
affect file content but may cause 
verification errors. 


Format: 


COPYSBF,Ifnj,Ifn2,n,na. 


Parameter Description 

Specifies the name of the file to copy. If this parameter is omitted, 
file INPUT is assumed. 

Specifies the name of the file to receive the copy. If this parameter 
is omitted, file OUTPUT is assumed. 

n Specifies the number of files (decimal) to copy. If this parameter is 

omitted, 1 is assumed. 

Specifies that the job step should not abort if a line terminator does 
not appear before an EOR. na can be any alphanumeric, one— to seven- 
character string. 
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The COPYSBF command copies n files beginning at the current position of Ifnj to file 
lfn 2 , shifting each line image one character to the right and adding a leading space. 

Each line image may contain up to 500 (6-bit) characters. Any characters beyond 500 are 
lost. A page eject character is inserted at the beginning of each logical record (refer to 
appendix I for a list of carriage control characters). If lfnj=lfn 2 , n files are 
skipped but no data transfer occurs. If the EOI is encountered before the file count is 
satisfied, an EOF is written to lfn 2 , and the operation tenoinates. 

If the COPYSBF command attempts to copy a line longer than 500 6—bit characters, the line is 
truncated, and an informative message is issued to the dayfile after the copying completes. 

If the last line of a record does not have an end-of-line terminator, the system issues a 
dayfile message. If the na parameter is not specified, the job step then aborts. 


COPYX COMMAND 

The COPYX command copies logical records of a file until a user-specified condition is met. 


NOTE I 


The COPYX command is not recommended for 
use with S, L, or F format tapes because it 
does not have the data specification 
parameters needed to accommodate the 
variety of data formats possible with those 
tape formats. For an S, L, or F format 
tape copying operation, issue a COPY 
command with the appropriate parameter 
specifications. 

When you copy a file with no EOR or EOF 
file marks, the resulting file may have a 
different logical file structure. In 
particular, when copying such a file to 
tape, the system adds an EOR mark to the 
end of the file. Such changes do not 
affect file content but may cause 
verification errors. 


Format: 

COPYX,Ifnj^ ,lfn2,x,b,c. 


Parameter 


Ifni 


Ifn, 


Description 


Specifies the name of the file to copy. If this parameter is omitted, 
file INPUT is assumed. 

Specifies the name of the file to receive the copy. If this parameter 
is omitted, file OUTPUT is assumed. 
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Parameter 


Description 


X 


b 


c 


Provides additional copy specifications. If omitted, one record is 
copied. The value for x may be one of the following: 


X 

Description 

n 

Copy n records, when n is a decimal number. 

00 

Copy all records up to and including first 
zero-length record. 

name 

Copy all records up to and including record of 
specified name (record name is first seven characters 
of record or the name in the prefix table, if 
present). 

type/name 

Copy all records up to and including record of 
specified type and name (refer to Library Record 

Types in section 15 for list of valid record types). 

Specifies the backspace control. If omitted, 0 is assumed. 

b 

Description 

0 

Do not backspace. 

1 

Backspace file Ifni one record after copying 
completes. 

2 

Backspace file lfn 2 one record after copying 
completes. 

3 

Backspace files Ifni and lfn2 one record after 
copying completes. 


Indicates that the copying to or from an S or L format tape should be 
performed in coded rather than binary mode. If coded mode is set on 
an SI tape, the system aborts the job. For mass storage files and I 
and F format tape files, the mode setting is ignored, c can be any 
alphanumeric, 1- to 7-character string. 


The COPYX command copies logical records from Ifn^ to file lfn2 at the current position 
of Ifni until the condition specified by x is met. It then backspaces the files according 
to the value specified by the b parameter. If an EOF or EOI is encountered on Ifn^ before 
the condition specified by x is met, the operation terminates and the backspace parameter b 
is ignored. If lfni=lfn2, the file is read until the termination condition is satisfied 
or an EOF or EOI is encountered. 


If EOI is encotintered on Ifni before the termination condition is satisfied, an additional 
EOR is written on lfn 2 only if data has been transferred since the previous EOR was 
written (or since the beginning of the copying if no EORs have been encountered). 
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DOCMENT COMMAND 


The DOCMENT command extracts either the external or internal documentation from an appropri¬ 
ately documented COMPASS or FORTRAN program. For output listing files not connected to your 
terminal, the DOCMENT command honors the page size and print density set for your job using 
the SET command and the PS and PD symbolic names. 

Format: 


DOCMENT,PI,... 


The parameters pj can be in any order, but must be in one of the follovd.ng forms. 
Parameter Description 

Omitted The first default value is assumed, 

a The alternate default value is assumed, 

a-x X is substituted for the assumed value. 


Any numeric parameter can be specified with a postradix character of either B or D. The 
parameter p^ can assume the following values (the default values are presented in a table 
after the descriptions): 


Pi 


I=lfni 


S=lfn 2 


L=»lfn3 


N=nn 


Description 


Specifies the name of the file that contains the page footing 
information; this must be a single statement in the following format. 

Column(s) Contents 

1 Blank 


2-45 Document title 

46-55 Publication number 

56-60 Revision level 


61-70 


Revision date 


Specifies the name of the file containing the source statement images 
from which to extract the documentation. This file is rewound by 
default unless the NR parameter is specified. 


Specifies the name of the file on which the output is to be written. 
Specifies the number of copies to be produced. 


T=type Specifies the documentation type: 

INT Internal documentation (detailed description of the 

internal features of the software). 

EXT External documentation (detailed description of the 

external features of the software). 

C=cc Specifies the octal display code of the key character for 

documentation. 
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Description 

p=pp 

Specifies the number of 

print lines per page. 

NR 

Disables 

rewind on the 

S (source) file. 

NT 

Negates 

table generator 

• 

TC 

Lists table of contents 

• 

The following are 

the default values for the 

parameters described. 

Parameter 

First 

Default 

Alternate 

Default 

Comment 

I 

0 

INPUT 

Page footing Information. If I Is 0, no 
footing Information Is printed. 

S 

CCMPILE 

SOURCE 

Source statement Images. 

L 

OUTPUT 

OUTPUT 

List file. 

N 

1 

1 

Number of copies (decimal). 

T 

EXT 

INT 

Documentation type. 

C 

47(*) 

03(0 

Octal display code of check character (two 
octal digits). 

P 

60 

80 

Number of print lines per page. This Is 
either the system default or the user-set 
value of the PS symbolic name (refer to the 
SET command In section 6). 

NR 

REWIND 

NO REWIND 

Source file rewind status. 

NT 

ON 

OFF 

Table generator statxis. 

TC 

OFF 

ON 

Table of contents status. 

Refer to Volume 4, 
standards followed 

Program Interface, for a detailed explanation of the documentation 
. Volume 4 also contains an example of external and Internal 


documentation for a sample program. 
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EVICT COMMAND 


The EVICT command releases file space for the specified files but does not release file 
assignment to the job unless you have the file assigned to a magnetic tape or cannot write 
on it. In this case, the system releases the file assignment to the job. 

Format: 

EVICT,Ifni,lfn 2 .If^n- 

Parameter Description 


Ifnj^ Names of the files to be evicted. 

The operation that EVICT performs depends on the file characteristics. 


File 


EVICT Action 


Permanent and 
primary files 
with write 
permission 

Deferred 

routed 

filet 

Read-only 

file 

Tape files 

All other 
files 


Releases all file space except the first track and writes an EDI on 
the first sector of the first track, but keeps file assigned to the 
job. 


Releases all file space and clears all file routing information. 

Unloads file. 

Releases tape from the job. 

Releases file space, but keeps file assigned to job. 


Evicting a tape file performs the same function as an UNLOAD command and so cannot be used 
to decrease the number of resource units scheduled via the RESOURC command. 


tRefer to the ROUTE command in this section. 
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FCOPY COMMAND 

The FCOPY conmand converts a file from one character code set to another. 
Format; 


FC0PY,P=lfni,N=lfn2,PC=csi,NC=cs2,PL=lti,NL=lt2,FL=fl,LB=lb,R,A. 


Parameter 


Description 


P=lfnj Specifies the file to be converted (default is OLD). Assign Ifnj^ to 

the job before performing the FCOPY operation. 

N=lfn 2 Specifies the file on which the converted data from Ifnj^ is written 

(default is NEW). If lfn 2 is not assigned to the job, FCOPY creates 
it. 


When copying from Ifnj^, the system normally reads Ifnj to EOI, 
preserving all EOR and EOF marks unless Ifn^ or lfn 2 is an S- or 
L-format tape. If an S- or L-format tape is specified for Ifnj^, the 
system reads Ifn^ only to the first tape mark. If an S- or L-format 
tape is specified for lfn 2 , the system reads lfn 2 only to the 
first EOR, EOF, or EOI encountered. If you want to copy an entire 
file to an S- or L-format tape, you can do so by first removing all 
EORs and EOFs using the PACK command. 


PC-CS 2 Specifies the code set of Ifnj. The default value for csj is ASCII. 


CS2 

tcy fC. ASCII 

I, & h 7" 7 

ASCIIS 

ASCII88 

ASC1I63 

ASCII64 

ASCFL 

I ' 

y —7b Dis 

DIS63 

DIS64 

EBCFL 


Description 

Specifies the 6/12-bit display code that supports the 
ASCII graphic 63- or 64-character set present on the 
current system. 


Specifies the 7-bit ASCII code, right-justified in 
12-bit bytes. 

Specifies the 8-bit ASCII code, right-justified in 
8-bit bytes. 


Specifies the 6/12-bit display code that supports the 
ASCII graphic 63-character set. 

Specifies the 6/12-bit display code that supports the 
ASCII graphic 64-character set. 


Specifies the 8-bit ASCII code on S- and L-format 
tapes (with fixed line length and no line 
terminators). 


Specifies the 6-bit display code that supports the 
CDC graphic 63- or 64-character set present on the 
current system. 

Specifies the 6-bit display code that supports the 
CDC graphic 63-character set. 

Specifies the 6-bit display code that supports the 
CDC graphic 64-character set. 

Specifies the 8-bit EBCDIC code set on S- and 
L-format tapes (with fixed line length and no line 
terminators). 
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Parameter Description 

NC=cs 2 Specifies the code set of lfn 2 . The default value for cs2 is ASCIIS. 
The possible values for cs 2 are the same as for csj. 


PL=lti Specifies the line terminator used for file Ifni. Table 9-2 shows 

valid line terminators for each code set. Values that can be specified 
for Iti are as follows: 

Value Line Terminator 

CR Carriage return. 

CRLF Carriage return and line feed. 

FF Form feed. 

LF Line feed. 

LFCR Line feed and carriage return. 

RS Record separator. 

US Unit separator. 

ZB Zero byte. 

n Specified octal character value (See table 9-2). 

The default value for Iti for most code sets is ZB. For ASCII88, the 
default is US. ASCFL and EBCFL do not use line terminators. 


NL=lt 2 Specifies the line terminator to be used in file lfn2. Table 9-2 

shows valid line terminators for each code set. Values that can be 
specified for lt 2 are the same as for the PL=lti parameter. The 
default value for lt 2 for most code sets is ZB. For ASCII88, the 
default is US. ASCFL and EBCFL do not use line terminators. 


Table 9-2. Code Set-Line Terminator Reference Chart 


Code Set 

ZB 

CR 

FF 

LF 

OS 

RS 

CRLF 

LFCR 

n 

DIS 

Y 

N 

N 

N 

N 

N 

N 

N 

0-7 7B 

DIS63 

Y 

N 

N 

N 

N 

N 

N 

N 

0-7 7B 

DIS64 

Y 

N 

N 

N 

N 

N 

N 

N 

0-7 7B 

ASCII 

Y 

Y 

Y 

Y 

Y 

Y 

N 

N 

0-77B, 

7400-7477B, or 
7600-7677B 

ASCII63 

Y 

Y 

Y 

Y 

Y 

Y 

N 

N 

0-77B, 

7400-7477B, or 
7600-7677B 

ASCII64 

Y 

Y 

Y 

Y 

Y 

Y 

N 

N 

0-77B, 

7400-7477B, or 
7600-7677B 

ASCIIS 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

0-177B 

ASCII88 

N 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

0-377B 

ASCFL 

N 

N 

N 

N 

N 

N 

N 

N 

N 

EBCFL 

N 

N 

_1 

N 

N 

N 

N 

N 

N 

N 


FL=fl Specifies the length of fixed length lines for S- and L-format tapes. 

The default value is 80 characters. This parameter is valid only if 
ASCFL or EBCFL was specified for csj^ or cs2. 
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Parameter 


Description 


LB=lb Specifies the number of lines per block for S- and L-format tapes. The 

default value is 3840 divided by the fixed line length (FL). (For 
example, if FL=80, the default for LB is 3840/80 or 48 lines per 
block.) For S-format tapes, the maximum value of FL*LB is 3840. This 
parameter is valid only if ASCFL or EBCFL was specified for csj or 
CS2. 


R 


Rewinds Ifnj and lfn 2 before and after the conversion. The default 
is no rewinding. 


A Aborts the FCOPY command if errors occur during the conversion. The 

default is not to abort when errors occur. 


FCOPY reads Ifnj to its EOT, preserving its EOR and EOF marks on the converted file unless 
Ifnj or lfn 2 is an S- or L-format tape. If Ifnj is an S— or L-format tape, FCOPY 
reads it only to the first tape mark. If lfn 2 is an S- or L-format tape, FCOPY reads 
Ifnj only to the first EOR, EOF, or EOI encountered. The maximum line length that can be 
processed is 160 12—bit codes or 320 6-bit codes. Lines that exceed the maximum length are 
truncated. 


Files converted to 7-bit ASCII code can be listed on a local batch printer (refer to the 
ROUTE command) but cannot be listed at an interactive or remote batch terminal. 
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LIST80 COMMAND 


The LIST80 routine reads a file containing list output produced by the COMPASS assembler and 
compresses It to 80 columns, which fits on 8-1/2-lnch by 11-inch printer paper. For output 
listing files not connected to your terminal, the LIST80 command honors the page length and 
print density set for your job using the SET command and the PL and PD symbolic names. 

Format: 


L1ST80,Ifnj,If02,NR. 


Parameter 


Description 


Ifni 


Specifies the file from which to copy; if this parameter is omitted, 
file LIST is assumed. 


Ifn2 


Specifies the file to which to copy; if this parameter is omitted, 
file OUTPUT is assumed. 


NR 


Indicates that Ifnj should not be rewound. 


The output listing omits the following information that appears on the COMPASS assembler 
output listing. 


• COMPASS version number on the page heading. 

• COMPASS assembler binary values. 

• INVENTED STMBOLS comment. 

• Symbolic Reference Table block column that contains either the system text file 
name, the overlay name, or the name of the block containing the symbol. 

Comments are truncated to column 65. 


LOCK COMMAND 

The LOCK command prevents writing on a file. 
Format: 


L0CK,lfnijlfn2,...,lfnn. 


Parameter 


Description 


Ifn^ Logical file name of a local file. 

With the LOCK command, you can set the write interlock for a local file. Subsequently, the 
system allows only read operations on the file. 
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L072 COMMAND 

The L072 command reformats files 


Format: 

L072,pj,P2,. 
Enter any of the 

2l 

I 

I=lfni 

1=0 


S 

S=lfn2 


L 

L=lfn3 


T 

T=x 


H 

H=xxx 


LP 

NR 


••Pn* 

following parameters in any order: 


Description 

Specifies that the reformat parameters are on file INPUT. 

Reformat parameters are on file Ifn^. 

There is no input file of reformat parameters. 

If the I parameter is omitted, 1=0 is assumed. 

Specifies that the data to be reformatted is on file SCR. 

Specifies that the data to be reformatted is on file lfn 2 . 

If the S parameter is omitted, SCR is assumed. 

Specifies that the reformatted data is listed on file OUTPUT. 

Specifies that the reformatted data is listed on file 1103 . Ifn 3 
is always rewound unless the NR parameter is specified. 

If the L parameter is omitted, OUTPUT is assumed. 

Specifies that the file to be reformatted is of type B. 

Specifies that the file to be reformatted is of type x. 

^ Description 

M Modify source data. 

C COMPASS source data. 

B Other source data. 

If the T parameter is omitted, B is assumed. 

Specifies that the number of characters per output line is 72. 

Specifies that the number of characters per output line is xxx (maximum 
allowed is 150 characters), xxx must be greater than or equal to the 
number of characters being moved (Nx) plus the starting column number of 
the destination field (Ox). 

If the H parameter is omitted, 72 is assumed. 

Specifies that the output is formatted for the line printer. 

Specifies that the output file is not rewound. 
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Description 


Pi 

Nx=y Specifies the number of characters to be moved (up to six 

fields). 

x(l to 6) Number of field being moved, 
y Number of characters being moved. 


NOTE 


The following restrictions apply to the H, 
N, I, and 0 parameters. 


(Nx+Ix).GT.150 

(NxK)x).GT.H 

H.GT.150 


Yields an error (1^_<6). 
Yields an error 
Yields an error. 


Ix=y Specifies the field from which the data originates. 

x(l to 6) Number of field being moved. 

y Starting column of originating field. 

Ox=y Specifies the destination field to which the data is going. 

x(l to 6) Number of the field to receive data. 

y Starting column of destination field. 

IT Suppresses query to terminal asking if you want to change any of the 

input parameters before processing begins. If omitted, query is 
Issued. This parameter is effective only from interactive origin jobs. 


The following 
various source 

shows the 
types. 

default 

values 

assumed for 

the N, 

0, and 

I parameters for 

the 

Type 

N1 

11 

01 

N2 

12 

02 

N3 

13 

03 

B 

72 

1 

1 

0 

0 

0 

0 

0 

0 

C 

7 

9 

1 

50 

41 

8 

15 

112 

58 

M 

2 

6 

1 

48 

10 

3 

22 

82 

51 

The remaining parameters 

of these types 

are defaulted to 

0. 





L072 reformats files (output files in general). You can rearrange each line (all lines must 
be formatted the same) in the format you choose. All default values compress output to 72 
columns, which is appropriate for terminal output or 8-1/2-lnch by 11-inch printer paper. 

If a 1 is encountered in column 1 (the page eject printer control character), the next two 
lines of source data are processed as a two-line header. This header is compressed to 72 
columns for all source types. If no page eject control characters are encountered, no 
headers are processed. 
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The followittg values apply to the first line of header and cannot be changed. 

Nl=42, 11=8, 01=0 (if LP not specified; otherwise, 01=1). 

N2=20, 12=90, 02=42. 

!I3=5, 13=115, 03=62. 

N4=5, 14=121, 04=67. 

The subheader lines for COMPASS and Modify listings are processed uniquely. 

For B listings, the following values apply to the reformatting. 

Nl=43, 11=8, 01=0 (if LP not specified; otherwise, 01=1). 

N2=29, 12=70, 02=43. 

All parameters are passed to L072 by the command. If an input file is specified, L072 reads 
it for additional input parameters. If the job originates from an interactive terminal, and 
the IT parameter is not specified, you are asked if you wish to change any of the input 
parameters. If you enter YES, the system prints the current parameter values and allows you 
to change them Individually. Pressing the carriage return key for any parameter leaves the 
parameter at its former value. In the following examples, the same input parameters are 
entered in three possible ways. 
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Examples 


Noninteractive entry of parameters from a terminal: 

/ lo72,i=0,s= source/.t=b, 1=0ut,n4=1,14=2,o4=75,h=90 

Interactive entry of parameters: 

/lo72 

DO YOU WANT TO CHANGE ANY CONTROL ARGUMENT VALUES- 
ENTER: YES OR NO 
? yes@ 

ARGUMENT VALUE 

INPUT FILE NAME: ?@ 

SOURCE FILE NAME: SCR ? source@ 

OUTPUT FILE NAME: OUTPUT ? out @ 

SOURCE FILE TYPE: BATCH ? b@ 

OUTPUT LINE LENGTH: 72 CHARS.? 

NO. OF MOVED FROM MOVED TO 
CHARS. COLUMN COLUMN 

(XO (NX) (IX) (OX) 

1. 72 1 1 

2 . 0 0 0 

3. 0 0 0 

4. 0 0 0 

5. 5 C[ W 

6 . 0 0 0 

ENTER CHANGES IN THE FOLLOWING FORMAT 
NX=AA*CR* 

IX=8B*CR* 

OX=CC*CR* 

ETC. 

TO CONTINUE, ENTER *CR* ONLY. ? n=4=1 ^ 

? 14=2@ 

? o4=75 '@ 

?@ 

LOTZ COMPLETE. 


Batch job entry: 
lJ072,I. 

where the input file has the following form: 

S=SOURCE,L=OUT,T=B. 

N4=1,14=2,04=75. 

H=90. 

-EOR- 

Each line in the input file must end with a terminator. 
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MFQUEUE COMMAND 


The MFCyJEUE command sends a local file from your host to the input or output queue of a 
remote host. The MFQUEUE command functions much like the ROUTE command. For most file 
transfers between mainframes, ROUTE is the preferred command. Unlike the ROUTE command, 
MFQUEUE provides the capability of sending a separate routing directive with the file or of 
indicating that the file has a nonstandard data format. The remote host processes the file 
according to the routing directive. Only when you need special routing specifications not 
provided by the ROUTE command do you need to use the MFQUEUE command. You must be 
authorized to use the MFQUEUE command (refer to the LIMITS command). 

Format; 

MFQUEUE, If n, ST=lid, DD=dd, I=dir f lie, PC=c, DC=dc. 


PARAMETER DESCRIPTIONS 

Parameters Ifn and ST=lid are required and Ifn must be the first parameter; the other 
parameters are optional and order-independent. 

Parameter Description 

Ifn Specifies the name of the local file to be routed to the remote host. 

The file name must be one to seven alphanumeric characters. 

ST=lid Specifies the logical identifier (LID) of the remote host to which the 

file is to be routed. The LID specification must be three 
alphanumeric characters. ST=lid may not specify the local host. 

DD=dd Specifies the data format of the file to be transferred. The DD=dd 

parameter both describes the character set of Ifn on the host where it 
currently resides and also specifies the character set Ifn is to have 
after the transfer. 

For file transfers between NOS mainframes and between NOS/BE and NOS 
mainframes this parameter.is effectively ignored. The file will have 
the same format on both mainframes. 

The interpretation of the DD=dd parameter depends on the operating 
system(s) involved in the file transfer. The following paragraphs 
describe how NOS interprets the DD=dd parameter. For its 
interpretation by other operating systems, refer to the Remote Host 
Facility Usage manual. 
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Parameter 


Description 


On NOS, you can specify the following values for dd: 
dd Description 


C6 The file contains character data in a 64-character (or 

less) subset of the ASCII 128-character set. The character 
code of Ifn is 6-bit display code and its lines are zero- 
byte terminated (Z-type records). 

C8 The file contains character data in a larger than 

64-character subset of the ASCII 128-character set. The 
character code of Ifn is the 7-bit ASCII code (right- 
justified in 12-bit fields) and its lines are zero-byte 
terminated (Z-type records). 

US Specifies that the file contains binary data in structured 

format with EORs and EOFs. The file is transmitted as a 
continuous string of binary data, broken only by EORs and 
EOFs as appropriate. 

UU Specifies that the file contains binary data without EORs 

and EOFs. NOS treats UU as US. 

If the file is character data, you do not need to specify a DD=dd 
parameter. The remote host determines the format in which to write the 
file. If NOS is the remote host and the DD=dd parameter has not been 
specified, NOS assumes character data and reads/writes the file in C6 
format. 

I=^dirfile Specifies the local file which contains the routing directive that the 
system sends to the remote host. The file name must be one to seven 
alphanumeric characters. If you specify only the keyword I, file 
INPUT becomes the directive file. If you omit the I=dirfile parameter, 
the system reads directives from the lines Immediately following the 
MFQUEUE command. The lines must begin with the prefix character 
defined by the PC=c parameter. The system reads the lines until it 
comes to a line without the prefix character. It then strips off the 
prefix character from each line and concatenates the lines into one 
single directive to send to the remote host. This directive must not 
exceed the 256-character limit. 

PC=c Specifies the prefix character for the lines of the routing directive. 

The default is an asterisk (*). The prefix character can be any 6-bit 
display code character, except a closing parenthesis, a dollar sign, a 
period, or a colon. To avoid ambiguity between commands and routing 
directives, use alphabetic values for c cautiously. 
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Parameter 

DC=dc 


Description 

Specifies the disposition codes for the file to be transferred. You 
can specify one of the following codes for dc: 

dc Description 

CP Punch-the file in coded format, 

IN Queue the file for input. 

IX Queue the file for input but do not return the output 

unless explicitly directed to do so. 

LP Print the file. 

PB Punch the file in system binary format. 

PH Same as CP. 

PR Same as LP. 

PU Same as CP. 

P8 Punch in 80-column binary format. 

SB Same as PB. 

SP Plot in binary format. 

Example; 


To route a 7—bit ASCII file (MYFILE) to a remote mainframe (with REM 
as its LID) for execution, enter this command: 

MFQUEUE,MYFILE,ST=RE«,DC=IN,DD=C8. 


THE ROUTING DIRECTIVE 

The routing directive provides additional routing specifications for the queued file. The 
I=dirfile parameter determines the residence of this directive. The host strips the prefix 
characters from the lines of this directive and forwards the directive unaltered (except for 
characters) to the remote host for processing. Hence, the directive must be a command 
recognized by the remote host. 

This section documents only the routing directive recognized by a NOS 2 remote host. For 
information on routing directives for other remote hosts, refer to the Remote Host Facility 
Usage manual. 

The routing directive accepted by a NOS 2 remote host closely resembles its ROUTE command. 
Format: 

ROUTE,lfn,P|,P2,... 

The parameter descriptions for this directive are the same as those for the ROUTE command 
with the following exceptions: 

• The Ifn parameter is not required on the ROUTE directive and can be omitted. 
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• Parameters pj^ can be any of the following as described for the ROUTE command: 


EXAMPLE: 


DC=dc 

DO=lid 

EC=ec 

FC=fc 

FID=fid 


FM=fm 

IC=ic 

ID=id 

PI=pi 

REP=rep 


SC=sc 

SCL=scl 

TID=tid 

UJN=ujn 

UN=un 


Assume you are at mainframe MFA. To route local file REPRINT from mainframe MFA to a 
remote batch printer logged in with user name ABC on NOS mainframe MFB, enter a command 
similar to the following: 


MFQUEUE,RBPRINT,ST=MFB. 
♦ROUTE,DC=PR,UN=ABC. 


You can accomplish the same task with the following ROUTE command: 
ROUTE,RBPRINT,DC=PR,UN=ABC,ST=MFB. 


NEW COMMAND 

The NEW command creates a primary file. 

Format: 

NEW,lfn/ND. 

Parameter Description 


Ifn Specifies the name of the file to be made the primary file. 

ND Specifies that no files currently assigned to the job are released. 

The NEW command creates an empty file and makes it your new primary file. If you do not 
specify the ND parameter, the system releases all files assigned to the job, except those 
with checkpoint or no-auto-drop status. Certain system files (for example, ZZZZZCO, 

ZZZZZCl, ZZZZZC2, and ZZZZZLD) always have no-auto-drop status. You can give any local file 
this status by using the SETFS command. When the ND parameter is specified, any currently 
existing primary file becomes a nonprimary local file. 

The automatic rewinding of primary files is incompatible with some file manipulation 
commands. Refer to the note in PRIMARY command later in this section. 
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OUT COMMAND 


The OUT command queues files that you or the system has given a deferred routing (refer to 
the ROUTE command, which is described later In this section). The command Initiates the 
queueing that the system automatically does at job termination. 

Format: 

OUT. 

or 


OUT, *, Ifni. If 112. • • •. Ifiin* 

The first format queues all eligible files. The second format queues all eligible files 
except those named (Ifni), ^f n® files are named, all eligible files are queued. 

Any file given a deferred routing can be processed by the OUT command. Eligible files also 
include local mass storage files named OUTPUT, PUNCH, PUNCHB, and P8. If selected, OUTPUT 
is queued for printing and files PUNCH, PUNCHB, and P8 are queued for punching. 

J'ils PUNCH is punched as a coded deck in either 026 or 029 mode, depending on the origin of 

the job. If the job is a local batch job, PUNCH is punched in the initial keypunch mode of 

the job s command record. For all other job origin types, PUNCH is punched in the system 

default keypunch mode. 

File PUNCHB is punched as a binary deck in system binary format. File P8 is punched as a 
binary deck in 80-column binary format. 


OVWRITE COMMAND 

The OVWRITE command destroys the contents of files by overwriting them. This command does 
not apply to tape files or to files on which you cannot write (for example, direct access 
files attached in a mode besides WRITE or files that have been locked). The command 
overwrites the entire file. 

Formats: 


OVWRITE,lfni,lfn2,...,lfn5,/0P=piP2. 

or 


OVWRITE,*, If ni,Ifn2,..., Ifiini/0P=pip2. 


Parameter Description 

Ifnj^ Specifies a file assigned to your job. This file cannot be a tape 

file. 


0P=piP2 Specifies how the files are to be overwritten and whether the files 

are to be released from the job after the overwriting. The value pj^ 
can be any of the following: 
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Parameter 


li 

z 


Description 


Description 


X 


R 


Overwrite the files with zeroes. This is the 
default. You cannot specify both Z and X. 

Overwrite the files first with zeroes, then with ones, 
and then with an alternating pattern of ones and 
zeroes. You cannot specify both Z and X. 

Release the files from the job after overwriting them. 


The first format shown overwrites files Ifnj^. The second format overwrites all files 
assigned to the job except files Ifn^. 


PACK COMMAND 


The PACK command removes all EOR and EOF marks from a specified file and copies it as one 
record to another file. 

Format: 


PACK,Ifn^,Ifn2,X. 


Parameter Description 


Ifnj Specifies the name of file to be packed. From batch origin, Ifnj 

must be specified; from interactive origin, the primary file is used 
if Ifn^ is omitted. The file must not be assigned to a interactive 
terminal (file type TT). 


Ifn 2 Specifies the name of file to receive packed data. If lfn 2 is 

omitted, the packed file is written on Ifn]^. 

X Indicates that Ifnj should not be rewound before the pack occurs, x 

can be any alphanumeric, one- to seven-character string. 

The input file, Ifnj, may consist of any number of records or files. If no third parameter 
is supplied, Ifni read from the BOI to the EOI, and all EOR and EOF marks are removed. 

It is written to file lfn 2 at the current position as one record. File lfn 2 is rewound 
after the pack; Ifni not. 




Do not use the PACK command with S, L, or F 
format tapes. 
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PRIMARY COMMAND 

The PRIMARY conmand makes a local file the primary file, or it creates an empty primary file. 
Format: 

PRIMARY,Ifn. 

Parameter Description 


Ifn Specifies the name of local file. 

Ifo already exists, it must be a local mass storage file in order to be made the primary 
file. If Ifn does not exist, the PRIMARY command creates it on mass storage. Any currently 
existing primary file (other than the Ifn specified) becomes a nonprimary local file. If 
the specified file is already primary, the operation is ignored. 


NOTE 


The primary file is rewound before every 
command is processed. Therefore, the file 
manipulation commands cannot be used to 
position within the file. An attempt to 
add to the file using one of the copying 
commands may result in writing over existing 
data at the BOI. 


RENAME COMMAND 

The RENAME command changes the name of a local file. 

Format: 

RENAME,nfni“ofnj,nfn 2 *ofn 2 ,..., nfnn=ofn^. 

Parameter Description 

nfoi Specifies the new name of the local file. 

ofn^ Specifies the existing name of the local file. 

The RENAME command changes the name of the local file ofn^ to nfu^. This does not 
change the names of files In the permanent file catalog. The renaming is done In the 
following manner: 

• If local file nfn^ did not previously exist, file ofn^^ is simply renamed. 

• If a local file nfnj^ already exists and is not the primary file, the system 
discards nfu^^ and gives ofnj^ the name nfnji^. 

• If nfn^ is the primary file, then the system discards nfn^, gives ofn^ the 
name nfn^, and makes it the primary file. In this case, ofn^ must have a local 
file type. 


60459680 D 


9-37 




For example, you have only two files assigned to the job. File A is a local mass storage 
file and file B has a queued file type. If you issue the following request 

RENAME,X=A. 

file A is renamed file X, and its file type (local) is not changed. If you issue the request 
RENAME,B=A. 

file B no longer exists; file A is renamed file B and retains its local file type. 


REQUEST COMMAND 

The REQUEST command assigns a file to receive checkpoint dumps or sends a message to the 
system operator requesting that the named file be assigned to the device described in the 
comment field. 

Format: 


REQUEST,lfn,checkpoint,AL=level.comment 


Parameter 

Ifn 

checkpoint 


Description 

Specifies the name of the file to be assigned to a specified device or 
to be used as a checkpoint file. 

Specifies that Ifn is to be used as a checkpoint file. 
checkpoint Description 

OC Each new dump is written at EOI of Ifn. 

CB Each new dump is written at BOX of Ifn. 


comment Specifies the comment that is displayed at the system console. In the 

comment field, you direct the operator to make the requested device 
assignment. 


AL=level Specifies the security access level to assign to the file. Unless 

changed by your site, level can be one of the following names: 

LVLO, LVLl, LVL2, LVL3, LVIA, LVL5, LVL6, or LVL7 

The default is the current access level of the job. 


On a secured system, the access level you specify must be valid for 
the job (ENQUIRE,B returns this information) and for the device to 
which you are assigning the file. 

On an unsecured system, the parameter has no effect. The system does, 
however, check for valid parameter specifications. 


When using this command to assign a file for checkpoint dumps on a 
secured system, use the AL»level parameter to assign the file at the 
highest access level valid for the job (ENQUIRE,B returns this 
information). The CKP command aborts the job if the checkpoint file 
is not at this access level. 
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If the RE^}EST coBanand is used to request assignment of file Ifn to the equipment specified 
in the camnent field, Ifn must not be a local file. 

If the REQUEST command is used to assign Ifn for checkpoint duiqps, Ifn must be a local file 
cund either the CK or CS keyword is specified. These keywords are used in conjunction with 
the CKP 2 uid RESTART conmands; they do the following: 

• Save all checkpoint dun^s by appending each dunp to chec]q>oint file Ifn: 

REQUEST,Ifn,CK. 

• Save only the last checlqjoint dun^ by writing each dun^ at the beginning of check¬ 
point file Ifn: 

REQUEST,Ifn,CB. 

• Save two consecutive checlcpoint duo^s by alternately writing on two checkpoint 
files: 

REQUEST,Ifni,CB. 

REQUEST,Ifn2,CB. 

If the CK keyword is specified for different files or if more than two checkpoint files are 
specified, the job aborts. The CK ^uld CB keywords specify a checkpoint file that is local 
to the job. You can make the checkpoint file pe^n^nlent by placing a DEFINE conmandt before 
the REQUEST command. 

DEFINE,Ifn. 

REQUEST,Ifn,CK. 

CKP. 

You are not required to supply a REQUEST ccxnmand to define a checkpoint file. You can use 
an ASSIGN or LABEL command or you can use default values. 

If no REQUEST command specifying a chec]q}oint file has been detected when the first CKP 
command is encountered, the system requests a device, specifies a file name of CCCCCCC, and 
selects the CK option. For a subsequent restart job, however, the system assumes you have 
made the checkpoint file available. 

If Ifn is a local file when you enter the REQUEST command, no new assignment is made and job 
processing continues with the next command. However, you can reassign Ifn by issuing a 
RETURN ccanmand on the file before entering the REQUEST command. 

You can use the REQUEST command to assign a file to a mass storage device. However, you 
must be authorized to assign a file to a magnetic tape or auxiliciry device. If you do not 
have this authorization and attenpt to request a tape unit or auxiliary device, the system 
aborts the job. 

The REQUEST command can also be used to create or access existing unladjeled tapes. If a 
magnetic tape assignment is needed to satisfy a REQUEST command, specify the DTsdty 
parameter. For a description of magnetic tape assignment with the REQUEST command, refer to 
section 12, Tape Management. 


tAny mass storage file used as a checkpoint file must have write permission. 
Refer to LIMITS Command in section 7. 
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RESEQ COMMAND 


The RESEQ ccxnmamd resequences source files which have leading sequence numbers or adds 
sequence nvmdsers to an unsequenced file. The RESEQ command for interactive jobs acts only 
upon the primary file and has a different parameter order. 

Format for noninteractive jobs: 

RESEQ,Ifn,type,start,step. 

Format for interactive jobs: 

RESEQ,start,step,type. 

Parameter Description 

Ifn Specifies the sorted file to be resequenced. The system does not sort 

Ifn (refer to the SORT ccmmand) . 

type Specifies the type of file: 


type 

B 


T 


Description 


BASIC source code. The system updates BASIC statements 
containing line references. 

Text source information; a five-digit sequence number 
plus a blank is added at the beginning of each line. 

The file text, however, is not inspected. Thus, if 
line numbers curently exist, two set of line nuiribers 
result. 


F Files that contain FORTRAN source code. The system 

adds a five-digit line n\mnber to the beginning of each 
line without a line number but adds no blemks. If your 
FORTRAN source file does not have sequence numbers, 
specify this parameter to resequence the file. 

Any number at the beginning of a line is considered a 
sequence number and is resequenced according to the 
start and step parameters; numbers are added to lines 
where no leading sequence numbers are present. You ceui 
use this option with a FORTRAN source file without 
destroying the integrity of statement labels if the 
file has leading sequence numbers. 

start Specifies the new line number of the first line. The default is 100. 

step Specifies the line number increment. The default is 10. 

Files that have leading sequence numbers include FORTRAN auid BASIC source files formatted 
for interactive processing. If the file has no leading sequence numbers, five-digit nianbers 
are inserted at the beginning of each line. No line number can exceed 99999. When the 
system encotinters line numbers longer them five digits, it uses only the first five digits 
to resequence the file. 


other 

or 

omitted 
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When resequencing a BASIC source program, you must specify B for the file type parameter or 
enter the command under the BASIC subsystem so that the system changes the line number 
references within the source statements. The system supplies 5-dlglt line numbers and line 
number references; excess surrounding blanks are used In the expansion of line number 
references. 

In order to resequence a BASIC program written In 6/12-blt display code, you must call RESEQ 
from an Interactive job which Is In ASCII mode. 

Example: 


File X contains the following BASIC source statements. 


95 ON SGN(A)+2 GOTO 100,110,120 'COMHENT 

100 PRINT "A IS NEGATIVE" 

105 GOTO 130 'COMMENT 

110 PRINT "A IS ZERO" 

115 GOTO 130 'COMMENT 

120 PRINT "A IS POSITIVE" 

130 LET B=A+130 
135 END 

The following command changes the contents of file X. 
RESEQ,X,B,90,10. 


File X now has the following contents: 


00090 ON SGN(A)-t-2 GOTO 00100,00120,00140 'COMMENT 
00100 PRINT"A IS NEGATIVE" 

00110 GOTO 00150 'COMMENT 

00120 PRINT "A IS ZERO" 

00130 GOTO 00150 'COMMENT 

00140 PRINT "A IS POSITIVE" 

00150 LET B=A+130 
00160 END 


The RESEQ command changes the line numbers and the line number references. Line numbers now 
begin at 90 and Increment by 10. The comment on the first line is moved to the right to 
allow for the expanded line number references. 

The RESEQ command retains at most one trailing space on a blank line. During a sort, the 
system deletes lines with only one or no trailing spaces. Hence, a RESEQ command followed 
by a sort causes all blank lines to be deleted from the file. 
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RETURN COMMAND 


The RETURN command releases files assigned to a job and may release file space depending on 
the file type. 

Format; 

RETURN, Ifni»“2 • • • • > *»n* 

or 

RETURN, *, If ni, If n2,... , If njj. 

Parameter Description 

Ifn^ Specifies the name of a file assigned to your job. 

The first format returns the named files (lfni,lfn 2 ,..•jlfn^^). The second format 

returns all files assigned to the job except the named files. If no files are named on the 

second format, the asterisk returns all files assigned to the job. 

There are several exceptions. The RETURN command does not release any files that have 
checkpoint or no-auto-drop status. Certain system scratch files (for example, ZZZZZCO, 
ZZZZZCl, ZZZZZC2, and ZZZZZLD) have no-auto-drop status. You can give any local file this 
status by using the SETFS command. 

RETURN performs the following operations according to the file type. 

Type Operation 

Input File name is changed to INPUT*. File space is not released (refer to 

Input File Control in section 3 for further information). 

Queued File space is released, and the file is no longer assigned to the job. 

The file also loses its queued status. 

local File space is released, and the file is no longer assigned to the job. 

Primary Same as Local. 

Library File space remains, but the file is no longer assigned to the job. 

Direct access File space remains, but the file is no longer attached to the job. 

Tap® Tape is no longer assigned to the job. Refer to the REWIND or UNLOAD 

command for a description of the processing that occurs if the previous 
operation was a write. 

In addition, the return of a magnetic tape file or the return of your last direct access 
file on an auxiliary removable disk pack decrements the resource demand count as scheduled 
by the RESOURC command if, and only if, the total concurrent resource demand (tapes and 
removable packs) is presently assigned. 

To release a file without decrementing the resource demand count, you can issue an UNLOAD 
command. To release file space without releasing the file from the job, you can issue an 
EVICT command. 
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If the file is a magnetic tape file smd if the previous operation was a write, the following 
operations are performed: 

• If the tape is AHSI labeled, the system writes a tape mark, an EOFl label, and three 
tape marks and then returns the tape. 

• If the tape is unlabeled cuid the data format specified on the ASSIGN, IiABEL, or 
request command is S, L, or F, the system writes four tape marks eind then returns 
the tape. 

• If the tape is xinlabeled and the data format is I, LI, or" SI, the system writes a 
tape mark, an EOFl label, and three tape marks cuid then returns the tape. 

Refer to Magnetic Tape Files in section 2 cuid Tape Management ccmmeuid in section 12 for 
further information about tape files, and to appendix G for a description of an EOFl label. 


REWIND COMMAND 


The REWIND ccmimand rewinds files. A mass storage file is positioned at its BOI. A tape 
file is positioned at BOI (refer to appendix G). If the labeled tape file begins on a 
previous volume, the system notifies the operator to mount that volume. 

Format: 

REWIND,Ifni'^^“2»•••»l^^n• 
or 

REWIND,*,Ifn^,Ifn2,...,lfnn. 

Parameter Description 


Ifnj^ Specifies the name of a file assigned to your job. 

The first format rewinds the named files (lfni,lfn 2 ,...,lfnjj). The second format rewinds 
all files assigned to the job except the named files. If no files are named on the second 
format, the asterisk specification rewinds all files assigned to the job. 

If the previous operation on the magnetic tape file was a write, a REWIND command causes the 
following operations to be performed. 

• If the tape is ANSI labeled, the system writes a tape mark, an EOFl label, and three 
tape marks and then rewinds the tape. 

• If the te^e is unlabeled and the data format specified on the ASSIGN, LABEL, or 
REQUEST command is S, L, or F, the system writes four tape marks cuid then rewinds 
the tape. 

• If the tape is unlabeled and the data format is I, LI, or SI, the system writes a 
tape mark, am EOFl latbel, amd three tape maurks and then rewinds the tape. 

Refer to Magnetic Tape Files in section 2 amd to section 12, Tape Mamagement, for further 
information about tape files, and to appendix G for a description of EOFl labels. 
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ROUTE COMMAND 


The ROUTE command queues a file for disposal. The file routing may take effect when the 
coomand is processed, or it may be deferred. If deferred, the routing characteristics 
specified define the handling of the file in later job steps or at job termination. This 
comnand can also rescind a prior deferred ROUTE command. 

With the proper validation, you can use the ROUTE command to queue files on other mainframes. 
Enter the LIMITS command to display the limits and user permissions for your user name. The 
MFQUEUE comnand may also be used to queue files on other mainframes, but you should use the 
ROUTE comnand for this purpose unless you need special routing specifications not provided by 
ROUTE. 


PARAMETER DESCRIPTIONS 

Format: 


ROUTE,Ifn,p^,P2,...,Pj^. 


Parameter Description 

Ifn Specifies the file to route. File Ifn must have a queued file type or a 

local file type; it cannot be a primary or direct access file. The Ifn 
parameter is required on all ROUTE commands. 

The remaining parameters are order-independent. 

Pi Description 

DC=dc Specifies the disposition of the queued file. 

dc Meaning 

IN Queue the file with an input disposition. Normal job input 

file format is required and the first record of the file 
must be in 6-bit display code. If the Job command within 
the file is in error, the file is not queued and remains a 
local file. 

LP Queue the file for printing on any printer. 

LR Queue the file for printing on 580-12 printer. 

LS Queue the file for printing on 580-16 printer. 

LT Queue the file for printing on 580-20 printer. 

LX Queue the file for printing on 5870 Non-Impact Printer. 

NO Queue the file with an input disposition. Output not 

explicitly routed by the job is discarded at job completion. 
The dayfile is not written to file OUTPUT. Normal job input 
file format is required and the first record of the file 
must be in 6-bit display code. If the Job command within 
the file is in error, the file is not queued and remains a 
local file. 
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Pi 


Description 


dc Meaning 

FB Same as SB. 

PH Same as PU. 

PL Queue the file for plotting. 

PR Same as LP. 

PU Queue the file for punching in coded format. 

P8 Queue the file for punching in 80~column binary format. 

SB Queue the file for punching system binary format. 

SC Rescind prior routing and change the file type to local. 

If no prior routing exists, SC is ignored. 

TO Queue the file with an input disposition and queue its 

output with a wait disposition unless the job routes it 
elsewhere. Normal job input file format is required. If 
the Job command within the file is in error, the file is 
not queued and remains a local file. 

WT Queue the file with a wait disposition. 

If the DC=dc parameter is omitted and Ifn has been previously given a 
deferred routing, the file is queued with the disposition code 
previously specified. If the DC»dc parameter is omitted and Ifn is 
not a deferred routed file, the file name may determine the default. 


If DC is omitted and Ifn is 
OUTPUT 
PUNCH 
PUNCHB 
P8 


ROUTE assumes DC=dc is 
DC=LP 
DC=PU 
DC=SB 
DC=P8 


If a ROUTE command specifies an input disposition for the file (DC=IN, 
DC=NO, or DC=TO) and the file has an invalid USER command, the job 
containing the ROUTE command aborts with no exit processing. The 
security count for the user name that did the ROUTE is decremented 
accordingly. If you specify a remote host (ST=lid 2 ) that does not 
perform USER command validation, the local host does not check your 
queued file for a USER command. 


If a ROUTE command sends a file to a remote host with an input 
disposition not supported on that host (for example, DC=TO or DC=NO to 
a non-NOS 2 host), the remote host accepts the input file but treats 
it as though it were routed with DC=IN. Hence, job output from a job 
routed to a non—NOS 2 host with DC=NO or DC=TO returns and prints 
locally. 
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Description 


On a dual-state system, if DC=NO is specified when routing a NOS/VE 
batch job from NOS, the job output is discarded at termination of the 
NOS/VE job. If DC=TO is specified, job output is queued with a wait 
disposition. 

Indicates that queueing of the file is deferred to a later job step 
(OUT command or ROUTE command with the SC parameter specified) or end 
of job. If this parameter is specified, the file is created if it 
does not exist. DEF is not allowed if DC=IN, DC=NO, or DC=TO. 

Specifies the logical identifier (LID) of the mainframe to receive the 
output generated by the routed file. The LID can be any three- 
character, alphanumeric string defined by your site or you can specify 
an asterisk. 

By default, output returns to the originating mainframe, including 
cases where your routed file submits jobs to still other mainframes. 
For example, you are at mainframe MAA and you route job X to mainframe 
MBB. Job X routes job T to mainframe MCC. Then the output from both 
jobs X and Y return to mainframe MAA by default. 

D0=* returns the output to the mainframe that processed the ROUTE 
command on which D0=* appears. For example, you are at mainframe MAA 
and you route job A to mainframe MBB, Job A routes job B to mainframe 
MCC with D0=* specified. Then output from job A returns to MAA but 
output from job B returns to MBB. 

In both preceding examples, all the mainframes must be directly 
connected; that is, no two mainframes have to rely on a third for file 
transfers. 

You must have special authorization to use this parameter (refer to 
the LIMITS command). 

Defines external characteristics for files queued for printing or 
punching. 

For files queued for printing, ec can be the following. (For more 
information on print trains associated with various EC codes, refer to 
Jobs Using Line Printers in appendix A.) 

ec Meaning 

A4 Provided for NOS/BE compatibility. If you specify A4, the 

system uses the appropriate EC default (refer to following 
note). 

A6 ASCII graphic 63/64-character set. 

A9 ASCII graphic 95-character set. File Ifn can be a 6/12 

ASCII file provided IC=ASCI16 is specified. If the IC 
parameter is not specified, file Ifn must be a 7-bit 
(8/12) ASCII file. Refer to the FCOPY command earlier in 
this section for information on how to convert a file to 
7-bit (8/12) ASCII. 
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Description 


FC=value 


ec 

B4 

B6 


Meaning 

Provided for NOS/BE compatibility. If you specify 
B4, the system uses the appropriate EC default 
(refer to following note). 


CDC graphic 63/64-character set. 

For files queued for punching, ec can be the following. 

Meaning 


ec 



ASCII 


Punch 

026 or 

026 

Punch 

029 or 

029 

Punch 

SB 


Punch 

80C0L 


Punch 


For files queued for plotting, ec can have the following values: 


ec 

T6 

T8 


Meaning 

Specifies 6-bit, transparent plot data. 
Specifies 8-bit, transparent plot data. 


NOTE I 


If an invalid external characteristic is 
specified, the queued file processor cannot 
output the file. You must not specify a 
printing characteristic for a queued punching 
file or a punching file characteristic for a 
print file queued for printing. You also 
must not specify an external characteristic 
not available at the site. If EC is not 
specified, an appropriate EC default is set 
on the basis of the DC parameter setting and 
installation options. 


This parameter has two possible uses depending on your site or host 
configuration: 

For routing of output requiring special forms, specify FC»fc, where fc 
is a 2-character code assigned by the system operator to an output 
device. This prevents output of a file before its special forms are 
placed in the output device. In this case, omission of the parameter 
results in a null value. 
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Description 


Pi 


FID=ujn 


JM=fin 


IC=ic 


For sites supporting two 533/536 or 585 printers, an ASCII graphic 
64-character printer and an ASCII graphic 95-character printer, you 
can use the FC parameter to select either printer. Specify FC=AS to 
select the 95-character printer. In this case, omission of the 
parameter results in routing to the 64-character printer. 

FID is a NOS/BE parameter included for compatibility. Under NOS, this 
parameter performs the same function as the UJN parameter. 

Indicates routing to a remote batch or interactive terminal logged in 
with the family name specified. You must have special authorization 
to specify an alternate family name (refer to the LIMITS command). 

The one- to seven-character family name must be alphanumeric. If you 
specify only the keyword FM, implicit remote routing results (refer to 
Implicit Routing following the last parameter description). 

Specifies internal characteristics of the file; the value ic is one of 
the following: 


Ic Meaning 

DIS 6-bit display code. 

ASCII 7-bit (8/12) ASCII code, right-justified in 12-bit 

bytes. 

ASCII6 6/12 ASCII display code. 

ASCIIS 7-bit (8/12) ASCII code, right-justified in 12-bit 

bytes. (IC=ASCI18 is equivalent to IC=ASCI1.) 

BIN Binary. 

Except when routing ASCII 6/12 files, this parameter is normally not 
specified since its default is automatically established through the 
disposition code (DC=dc) and the external characteristic (EC=ec) 
parameters. The following lists show the default for ic for the 
various ec values. 

ec for printing Default ic 

A4 ASCII 


B4 DISPLAY 

B6 DISPLAY 


A6 DISPLAY 

A9 ASCII 


ec for punching 


Default ic 


SB 


BINARY 


80COL BINARY 


026 


DISPLAY 


029 DISPLAY 

ASCII ASCII 
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Pi 

lD=id 

PI=pi 

PRI=pri 

EEP=rep 

SC=sc 


Description 


Selects the device locally associated with identifier id. Identifier 
id can be 0 to 67B (octal default). If you specify only the keyword 
ID, implicit remote routing results (refer to Implicit Routing 
following the last parameter description). 

Selects a print train image denoted either by a digit from 1 to 7 or 
by a one- to seven-character symbolic name assigned by your site. 

File priority. This is a NOS/BE parameter included for 
compatibility. It produces an informative message under NOS. 

Specifies the number of additional file copies to be routed to a 
destination. The range for rep is from 0 to 63; therefore, the number 
of copies that can be sent ranges from 1 to 64. Values for rep beyond 
its range are set to zero, an informative message is sent to the 
dayfile, and one copy is routed to the destination. The default value 
is zero; only one copy is routed. 

Specifies a programmable format control (PFC) array for the 580 PFC 
printer, or a vertical format definition for a 533/536, 537, or 585 
printer. The system is released with two PFC arrays, a default 
(SC omitted or SC=1), and an alternate (SC=2). 

If your site has 533/536, 537, or 585 printers, the system contains 
six vertical format definitions for these printers with a default of 
SC=3. For more information on PFC arrays and vertical format 
definitions, refer to appendix H and the NOS Version 2 Analysis 
Handbook. 

For 533/536, 537, and 585 printers, you may choose one of the 
following sc values: 

sc Description 

1 12-inch forms at 6 lines/inch. 

2 12-inch forms at 8 lines/inch. 

3 11-inch forms at 6 lines/inch. 

4 11-inch forms at 8 lines/inch. 

5 8.5-inch forms at 6 lines/inch. 

6 8.5-inch forms at 8 lines/inch. 

If no sc value is specified, the system default (SC=3) is used. Refer 
to NOS Version 2 Analysis Handbook for more information on 533/536, 
537, and 585 printers. 
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Pi 


Description 


SCL=scl 


ST=lid2 


Specifies the service class to be assigned to this routed file. The 
value scl must be one of the following: 

scl Description 

BC Local batch. 

CX Communication task. 

DF The default service class according to the origin type 

of the routed file. The LIMITS command shows your 
default service class assignments. 

DI Detached Interactive. 

In Installation class n (0 _< n 3). 

MA Maintenance. 

NS Network supervisor. 

RB Remote batch. 

SY System. 

TS Interactive. 

When using the ROUTE command to queue a file to a remote host, the 
service class for your job must be valid on the remote host and all 
mainframes in the link to the remote host. 

For a file queued for output, you can only specify a service class 
valid for your current job. The default service class for such a file 
is the service class of the current job. 

For a file queued for input (DC=IN, DC=N0, and DC=T0), you can only 
specify a service class valid for local batch jobs. The default 
service class in this case is the service class the system assigns by 
default to any of your local batch jobs. If you specify a service 
class with this parameter for a file queued for input and the file's 
Job command also has a service class specification, the service class 
specified on the ROUTE command takes precedence. Refer to Job Service 
Classes in section 3 for more information on service classes. 

Specifies the logical identifier (LID) of the mainframe to which you 
are routing the specified file. The LID can be any three-character 
alphanumeric string defined by your site or you can specify an 
asterisk. 

By default, the mainframe processing the ROUTE command also processes 
the routed file if it is queued for input. This mainframe also 
processes the routed file if it is queued for output unless the job 
containing this ROUTE command emanated from another job that is 
diverting the output elsewhere. 

ST=* ensures that the mainframe processing the ROUTE command always 
processes the routed file. 
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TID=tid 

or 

TIDC 


UJN=ujn 


UN=un 


Description 


In a dual-state environment, you can route an input file to NOS/VE by 
specifying the NOS/VE LID on this parameter. The file must be in 
ASCII (6/12-bit display code) format. 

The ST=lid 2 on the ROUTE command overrides the ST=lid parameter on 
the Job command of the- routed file. 

You must have special authorization to use this parameter (refer to 
the LIMITS command). 

The TID=tid form of this parameter functions the same as the UN=un 
parameter and is included for compatibility with NOS/BE. The TID=C 
form of the parameter specifies routing to the central site. If you 
specify only the kejrword TID, implicit remote routing is selected 
(refer to Implicit Routing below). 

Specifies a user job name (UJN) for the file to be routed. The UJN 
can consist of 0 to 7 characters (alphanumeric and the asterisk (*) 
character). Except for input dispositions, the default is the UJN of 
the job from which you enter the command. In the case where you 
specify an input disposition (DC=IN, DC=NO, or DC=TO), the Job command 
of the queued file determines the default UJN. 

Specifies the user name of the remote batch or interactive user to 
whom the system routes the file. If you specify only the keyword UN, 
implicit remote routing occurs (refer to Implicit Routing following 
the last parameter description). 


IMPLIQT ROUTING 

For remote batch origin jobs, the following action is taken. 

• Specifying an ID, ID=id, or TID=C parameter causes routing to the central site. 

• Specifying an FM=fm or UN“un parameter with valid arguments causes routing to the 

specified remote batch or interactive terminal. 

• In all other cases, the system routes the file to the originating remote batch 
terminal. 

For jobs of any origin other than remote batch, the following action is taken. 

• Specifying an ID, ID=id, or TID=C parameter causes routing to the central site. 

• Specifying UN, TID, or FM causes routing to the terminal specified by the job's 

family name and user name at the time of the processing of the ROUTE command. 

• Specifying UN»mn or FM=fm with valid arguments causes routing to the specified 
remote batch or interactive terminal. 

You can use the ENQUIRE command to determine whether your routed file is destined for the 
central site or a remote batch terminal. If you specify the JSN=*jsn or UJN=ujn parameter, 
ENQUIRE returns either RB (remote batch routing) or BC (routing to the batch devices at the 
central site) in the DS field of the display. 


9-50 


60459680 N 



SCOPY COMMAND 


The SCOPY command copies a specified number of coded files from one file to another and, 
unless explicitly prohibited, indicates the structure of the file being copied by displaying 
the EORs and EOFs in the receiving file. A coded file is defined as a file containing lines 
of 500 characters or less, each terminated by a zero byte (12 zero bits in the lowest byte 
of a word). 


_NOTE I 

The SCOPY command is not recommended for use 
with S, L, or F format tapes because it does 
not have the data specification parameters 
needed to accommodate the variety of data 
formats possible with those tape formats. 

For an S, L, or F format tape copying 
operation, issue a COPY command with the 
appropriate parameter specifications. 

The SCOPY command cannot copy SI format 
tapes. If coded mode is set for an SI tape, 
the system terminates the job. The TCOPY 
utility converts SI coded tape files. 

When you copy a file with no EOR or EOF file 
marks, the resulting file may have a 
different logical file structure. In 
particular, when copying such a file to 
tape, the system adds an EOR mark to the end 
of the file. Such changes do not affect 
file content but may cause verification 
errors. 


Format: 

SCOPY,Ifni,lfn2,n,fchar,lchar,na,R,fcs,fline,nine,ns. 

Parameter Description 


Ifui Specifies the name of the file to be copied. You must specify this 

parameter. 

Ifn 2 Specifies the name of the file onto which Ifni is copied; if this 

parameter is omitted, file OUTPUT is assumed. 

n Specifies the number of files (decimal) to copy; if this parameter is 

omitted, the file is copied to EOI. 
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Parameter Description 

fchar Specifies the first character position (1 to 500 for 6-bit characters) 

of each line to copy; if this parameter is omitted, the copy begins at 
character position 1.+ 


Ichar Specifies the last character position (1 to 500 for 6-bit characters) 

of each line to copy; Ichar must be greater than or equal to fchar. If 
this parameter is omitted, the copy ends at character position 500.t 


na Specifies that the job step should not abort when a line terminator 

does not appear before an EOR. na can be any string of one to seven 
alphanumeric characters. 


R Specifies that both Ifnj^ and lfn 2 be rewoumi before copying. 

fcs Specifies the character set code of Ifn^. The value 0 indicates 

display code or 6/12-bit display code. 0 is also the default. No 
other values are allowed. 


fline Specifies the line number of the first line you want to copy from Ifnj 

if Ifni is a sequenced file. If you do not specify this parameter or 

if Ifni is not a sequenced file (no line numbers), the copying begins 
with the first line of Ifni. 

nine Specifies the line number of the last line you want to copy from Ifni 

if Ifni is s sequenced file. If you do not specify this parameter or 

if Ifni is not a sequenced file (no line numbers), the copying is 

controlled by parameter n. 

ns Specifies no structure reporting. If you specify a nonnull value, the 

system does not display the EORs and EOFs in lfn 2 . 


If EOI is encountered before the file count is satisfied, an EOF is written on lfn 2 , and 
the operation terminates. If a line is encountered that has more than Ichar characters, the 
excess characters are truncated. 


tSince many characters in 6/12-bit display code require 12 bits rather than 6, this 
parameter may produce unforeseen results when copying a file containing 6/12-bit display 
code data. Refer to Appendix A for a description of character set codes. 


9-52 


60459680 F 



SCOPY writes lines with an even number of characters. If an input line has an odd character 
count and the last character is a blank not immediately preceded by a colon, the last 
character is removed. If an input line has an odd character count and the last character is 
not a blank or is a blank immediately preceded by a colon, an additional trailing blank is 
appended. 

If SCOPY attempts to copy a line longer than 500, 6-bit characters, the line is truncated, 
and an informative message is issued to the dayfile after the copy completes. 

If the last line of a record does not have an end-of-line terminator, SCOPY issues a dayfile 
message. If the na parameter is not specified, the job step then aborts. 

Example: 

old,filea 
READY, 
list 

RECORD 1 
AAA 
BBB 
CCC 

RECORD 2 
DDD 
EEE 
FFF 

RECORD 3 
6GG 
HHH 
HI 

READY. 
scopy,filea 

RECORD 1 

AAA 

BBB 

CCC 

-EOR- 

RECORD 2 

DDD 

EEE 

FFF 

-EOR- 

RECORD 3 

GGG 

HHH 

III 

-EOR- 

-EOF- 


READY. 
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SECHDR COMMAND 


The SECHDR conmand adds security-related information to a file. You can choose to have this 
information placed on banner pages throughout the file, placed at the top and bottom of each 
page, or both. 

Format: 

SECHDR, If n,FF ,OP=p 2 ^P 2 p 2 P^. 

The parameter Ifn is required and must be the first parameter. The other parameters are 
optional and order-independent. 

Parameter Description 


Ifn Specifies a file assigned to your job. 

Specifies that the file has already been formatted for printing; that 
is, carriage control characters (such as those controlling page ejects 
and page density) have already been inserted. 

0F=P2^P2P3P4 Specifies where the security information will be inserted in the file. 
OP=B is the default. You have the following choices: 

Pi Description 

B Print the security information on two banner pages, 

one at the beginning of the file and one at the end of 
the file. 

F Print the security information on a banner page at the 

beginning and the end of every logical file within 
file Ifn. 

R Print the security information on a banner page at the 

beginning and the end of every logical record within 
file Ifn. 

P Print the access level of the file at the top and 

bottom of every page of output. 

You can specify any combination of these options. 
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The banner pages have the following header lines: 

FILE NAME = file name 
DATE PRINTED = yy/mm/dd 
USER NAME = user name 

where the lowercase characters represent job-specific information. Following those header 
lines, the system prints the security access level of the file in large block characters. 

Example: 

The following command specifies that security information is to be placed both in a header 
and a footer on each page of the file and also on banner pages that are to be printed at the 
beginning and ending of each logical file within FILE213: 

SECHDR,FILE213,OP=FP. 


SETFAL COMMAND 

The SETFAL command changes the security access level of a local file. In most cases, a 
local file receives the access level of the job that creates it. Refer to Security Features 
in section 3 for a detailed discussion of file access levels. 

Format: 

SETFAL,Ifn,AL=level. 

The two parameters are required and are order-dependent. 

Parameter Description 

Ifn Specifies a local file. The file cannot be a direct access permanent 

file or a magnetic tape file. 

AL*level Specifies the security access level you want assslgned to the file. 

Unless changed by your site, level can be one of the following names: 

LVLO, LVLl, LVL2, LVL3, LVL4, LVL5, LVL6, or LVL7 

On a secured system, the access level you specify must be valid for the job (ENQUIRE,B 
returns this information). In addition, to lower the access level of a file, you must be 
authorized to do so (refer to the LIMITS command). 

On an unsecured system, the system does not use this access level assignment in monitoring 
access to the file. It does, however, become an attribute of the file. 
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SETFS COMMAND 

The SETFS comnaad sets the autO“drop or no”auto-drop status on files assigned to your job. 

If given the no-auto-drop status, a file Is not released from your job by commands like NEW, 
OLD, CLEAR, RETUitN(*), and UNLOAD(*). 

Format: 

SETFS,Ifni,Ifn2,•••,lfnn/FS=fs. 
or 


SETFS, *, Ifni. Ifn2 > • • •»If s • 


Parameter Description 

Ifn^ Specifies the local file to be affected. 

FS=fs Specifies either the auto-drop (FS=AD) or no-auto-drop (FS=NAD) 

status. The default status for user-created files is auto-drop. 
Certain system files (for example, ZZZZZCO, ZZZZZCl, ZZZZZC2, and 
ZZZZZLD) always have the no—auto—drop status. 

The first format of the command gives the specified status to the files Ifn^. The second 
format gives the specified status to all files assigned to the job, except files Ifni. 

The CLEAR command never releases a file that has a no-auto-drop status, the RETURN and 
UNLOAD commands release such a file only if you specify it, and the NEW or OLD command 
releases such a file only if it has the same name as the new primary file. 


SKIPEI COMMAND 

The SKIPEI command directs the system to position the specified file at the EOI. 

Format: 

SKIPEI,Ifn. 

Parameter Description 

Ifn Specifies the name of the file to be positioned. 

On magnetic tapes where no EOI is defined, the operation stops at an EOF. 

The SKIPEI command has no effect on a primary file since the file is rewound before every 
operation. 
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SKIFF COMMAND 

The SKIPF command directs the system to bypass. In a forward direction, the specified number 
of files from the current position of the named file. 

Format: 

SKIPF,Ifn.n.m. 

Parameter Description 

Ifa Specifies the name of the file to be positioned. 

n Specifies the number (decimal) of files to be skipped; if the 

parameter is omitted, the system assumes 1. The maximum for n is 
262143. 

m Specifies the file mode: C for coded, B for binary. If m is omitted, 

the system assumes the file is in binary mode. If coded mode is set 
on an SI tape, the system aborts the job. 

If an EOI is encountered before n files are bypassed, file Ifn remains positioned at the EOI. 

The SKIPF command has no effect on a primary file since the file is rewound before every 
operation. 


SKIPFB COMMAND 

The SKIPFB command directs the system to bypass, in the reverse direction, the specified 
number of files from the current position of the named file. 

Format: 

SKIPFB,Ifn,n,m. 

Parameter Description 

Ifn Specifies the name of the file to be positioned. 

n Specifies the number (decimal) of files to be skipped; if the 

parameter is omitted, the system assumes 1, The maximum for n is 
262143. 

m Specifies the file mode: C for coded, B for binary. If m is omitted, 

the system assumes the file is in binary mode. If coded mode is set 
on an SI tape, the system aborts the job. 

If the system encounters BOI (or the load point of the current volume of a multlvolume tape 
file), SKIPF command processing ends. 

The SKIPFB command has no effect on a primary file since the file is rewound before every 
operation. 
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SKiPR COMMAND 

The SKIPR conrmand directs the system to bypass, in a forward direction, the specified number 
of logical record or file marks from the current position of the named file. 

Format: 

SKIPR,Ifn,n,leve1,m. 

Parameter Description 

Ifn Specifies the name of the file to be positioned. 

n Specifies the number (decimal) of record and file marks to be skipped; 

if this parameter is omitted, the system assumes 1. The maximum for n 
is 262143. 

level Specifies the level number; 0j<levelO7. If OQevel^lb, both EOR and 

EOF marks are counted. If level is 17, only EOF marks are counted. 

The default is 0. 

m Specifies the file mode: C for coded, B for binary. If m is omitted, 

the system assumes the file is in binary mode. If coded mode is set 
on an SI tape, the system aborts the job. 

Consecutive EOR or EOF marks are counted separately. If the EOI is encountered before n EOR 
and EOF marks are bypassed, file Ifn remains positioned at the EOI. 

The SKIPR command has no effect on a primary file since the file is rewound before every 
operation. 

SORT COMMAND 

The SORT command sorts a file of lines in numerical order based on leading line numbers 
consisting of a specified number of digits. 

Format: 

SORT,lfn,NC=n. 

Parameter Description 

Ifn Specifies the file to be sorted. Ifn may be a local file or a direct 

access permanent file assigned to your job. 

NC’n Specifies the number of leading line number digits to use in sorting 

the file. nOO. The default is 5. 

In the case of duplicate line numbers, all lines other than the first are considered 
correction lines. All lines with the same number are deleted from the file except the last 
line encountered. 

For input from an interactive terminal, SORT deletes a line if a line number is followed by 
an empty line or a line number is followed only by a blank. However, the system retains a 
line with more than one blank after the line number. 

For input from cards, SORT deletes a line if a card containing only the line number is 
submitted. 
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If a line number contains more than n digits, you can delete the line either by entering the 
first n digits of the line number and pressing the Ccirriage return (terminal input) or by 
su]:miitting a card containing only the first n digits of the line number (batch input) . 

After the sort, Ifn is packed and set at EOI. 


TCOPY COMMAND 

The TCOPY command copies X (external) format binauT^ tapes or E (Tine image) , B (blocked) , or 
SI (system internal) format coded tapes to mass storage, to an I format tape, to an LI 
format tape, or to an SI binary format tape. It also writes E or B format tapes converted 
from files on mass storage, I format tape, LI format tape, or SI format binary tape. The X 
binary and E, B, and SI coded tape formats were supported under earlier versions of NOS. 
Refer to appendix I for the tape formats of B, K, and X format coded tapes. Now, to access 
data or write data in one of these formats, the tape must be assigned as em S (stranger) 
format tape (refer to the tape assignment commands in section 12) and the file copied using 
the TCOPY command. 

Order-dependent format: 

TCOPY, Ifnj^, If n2, format, tc,copycnt, chaxcnt,erlimit,PiP2, lfn 3 ,ns. 

Order-independent format: 

TCOPY,I=lfn2^,0=lfn2,Reformat,TC=tc,N=copycnt,CC=charcnt,EL=erlimit, 

P0=PiP2,L=lfn 3 ,NS=ns. 


The parameters on the TCOPY command can appeeir in order-dependent format, order-independent 
format, or a combination of both. 


If order-dependent and order-independent parameters are mixed in one TCOPY command, the 
order-dependent parameters must appear in their proper position. All parameters are 
optional. However, the specification of certain parameters precludes the application of 
others. A nonappliccdsle parameter may be ignored or may generate an error. This is stated 
in the individual descriptions of the parcuneters. 

The pareuneters are defined as follows: 

Parameter Description Default 


I=lfn3 

0=lfn2 

F=format 


Specifies the file to copy. INPUT 

Specifies the file to receive the copy. ODTPDT 

Data format that specifies the type of conver- X 

sion for the copying operation. This can be 
any one of the following. 

format Conversion 

E Copy an E format tape to mass storage, an 

I, LI, or an SI binary tape file, or 
generate a new E format tape from mass 
storage, cui I, LX, or an SI binary tape 
file. The E tape must be unlabeled and 
assigned as S format. 
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Parameter 


Description 


Default 


format Conversion 

B Copy a B format tape to mass storage 

or to an I, LI, or SI binary tape 
file, or generate a new B tape fron 
mass storage or frcxn an I, LI, or SI 
binary tape file. The B tape must 
be unlabeled and assigned as S or L 
format. 

X Copy cui X format tape to mass 

storage or to an I, LI, or SI binary 
tape file. The xinlabeled input tape 
must be assigned as S or L format, 
with noise size of eight frames for 
seven-track tape or six frames for 
nine-track tape (refer to NS 
parameter on tape assignment 
command). 

SI Copy an SI coded format tape to mass 

storage or to an I, LI, or SI binary 
tape file. The laLbeled or unlabeled 
iiput tape must be assigned as S or 
L format, with noise size of eight 
frames for seven-track tape or six 
frames for nine-track tape (refer to 
NS parameter on tape assignment 
command). If the SI coded input 
tape is coopleted before EOI is 
encovintered, the position of the 
input tape after the copying is 
indeterminate. This is because 
control words are used on the SI 
coded tape read via S or L format 
(EOF on 6 U 1 SI coded tape is a level 
I7g block terminator, whereas EOF on 
an S or L tape is a tape mark). 

I Copy an I format tape to mass 

storage or to an I, LI, or SI format 
binary file. This option allows 
recovery of data from overwritten 
tapes. The labeled or unlabeled 
input tjpe must be assigned as an 
unlabeled L format tape. If the 
terminating condition specified is 
other than EOI, the position of the 
input tape after the copy is 
unknown. 
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Parameter 


Deeeription 


Default 


TC=tc 


N=cppycnt 


format Conversion 

I<X Copy 2 Ln 111 format tape to maes 

storage or to an I, LI, or SI format 
binary file. This option allows 
recovery of data from overwritten 
tapes. The labeled or unlsUseled 
iz^ut tape must be assigned as'an 
unlabeled L format tape. If the 
terminating condition specified is 
other than EOI, the position of the 
input tape after the copy is 
unknown. 


Specifies the termination condition for copying 
used in conjunction with N=copycnt. The 


Copy to double EOF 
(TC=Dor TC=EOD) 


termination condition can be specified as follows 

format 

Conversion 

F or 

EOF 

When this TC=tc value is set, the 
N keyword specifies the nimiber of 
files to copy. 

I or 

EOI 

This specifies copying to the end 
of information. The N keyword is 
ignored. 

D or 

EOD 

When this TC=tc value is set, the 
N keyword is the number of double 
EOFs to which to copy. 

Specifies 

condition 

the copy count used by the termination 
parameter TC=tc. 
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Parameter Description Default 

CC=charcnt Specifies the character count which determines 136 characters for 

maximiim block size (line length) in characters E format; 150 

for an E or B format tape. This parameter can characters for B 

only be specified for copying an E or B format format, 

tape. 

EL“erlimit Specifies the error limit, which sets the number Zero 

of nonfatal errors allowed before abort. An 
ELMO specification allows an unlimited number of 
errors before an abort. This Includes parity 
errors and block-too-large errors which are re¬ 
turned by the tape subsystem after completing 
recovery procedures. It also Includes invalid 
block format errors (Invalid byte-count coded 
format and/or unused bitcount) for X format and 
SI coded format tapes. Error limit is ignored 
when generating an E or B format tape from mass 
storage, an I format, and an SI binary format 
file since control word read is notused. Error 
limit is likewise ignored if the input file de¬ 
vice does not support control word read (termi¬ 
nals). In that case, any error aborts the job. 

P0=pip2 Specifies one or both of the following processing 

options (not separated by commas). 

E Input blocks with parity errors or block- Error blocks are 
too-large errors are processed (copied). skipped. 

T When generating a B or E format tape. Lines exceeding 

blocks exceeding the maximum block size the maximum line 

(refer to the CC“charcnt parameter) are size are split 

truncated. PO’^T is not allowed for other into multiple 

file conversions. blocks. 

L=lfn 3 Specifies the name of an alternate output file to ODTPUT 

receive parity error messages when extended error 
processing is in effect (nonzero EL specified), 
in which case, the file name lfn 3 must not be 
the same as lfn 2 . 

NS=ns Noise size. Any input block containing fewer than 

ns characters is considered to be noise and is 
discarded. This parameter is valid only for E 
format to B format conversions. The maximum value 
that can be specified for ns is 41. If NS=0 is 
specified, the default value of 18 is used. 

Example: 

The following TCOFY command combines order-dependent and order-independent parameters: 

TCOPY,TAPE1,PILE2,E,CC-200,EL=12. 
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The input file TAPEl is an E-format tape (assigned as an S-format tape). It has a maximum 
of 200 characters per line. The copying terminates when a double EOF is encountered 
(default). The output file F1LE2 can be a mass storage file or an I or SI binary format 
tape. The error limit allows up to 12 nonfatal errors (parity/block-too-large), and the bad 
data is skipped (default) with informative error messages written to the file OUTPUT 
(default). 

The TCOPY command begins a copying operation at the current position of both files and 
continues until the copy termination condition for copying is met or EOl is encountered. 

This termination condition can be a file count, double EOF count, or EOI. If the copying is 
terminated by a double EOF (for TC=E0D parameter), the second EOF is detected on Ifni 
is not transferred to lfn 2 . If lfni=lfn 2 , the named file is read until the termination 
condition is satisfied or EOI is encountered. An SI coded tape can be positioned correctly 
only to EOI (refer to the F=SI parameter description). 

If you specify a file count TC=E0F, and EOI is encountered on the input file before the file 
count is satisfied, an additional EOF is written on the output file only if data or records 
have been transferred since the previous EOF was written (or since the beginning of the 
copying, if no EOFs have been encountered). 

The EL=erlimit or P0=E parameters provide extended error processing. This allows the 
processing or skipping of blocks with parity errors or block-too-large errors. The block 
count for the first block to be copied is initially set to zero and is incremented by one 
for every block and every EOF processed. 

When creating a B-format tape from a mass storage, I, or SI binary format file, a block 
shorter than the noise size specified on the tape assignment statement is blank filled to 
the noise size. A noise block could also be generated when a block exceeding the maximum 
block size for the B-format tape is split into multiple blocks. If the P0=T parameter is 
specified, blocks exceeding the maximum block size are truncated. 

When creating an E-format tape from a mass storage, I, or SI binary format file, blocks that 
exceed the maximum block size for the E-format tape are split into multiple blocks. If a 
continuation block contains only the end—of-line indicator (zero word), the continuation 
block is discarded. If the P0=T parameter is specified, blocks exceeding the maximum block 
size are truncated (all continuation blocks are discarded). 


TDUMP COMMAND 

The TDUMP command lists a file in hexadecimal,,octal, or alphanumeric format. It dumps the 
entire file or the specified number of lines, records, or files. If more than one limit is 
set, the limit reached first overrides the others. If you are in ASCII mode (refer to the 
ASCII command in section 8) and the output file is assigned to your terminal, TDUMP 
interprets input and displays alphanumeric output as 6/12-bit display code. 


NOTE 


TDUMP produces unpredictable results when 
dumping an S-, L-, or F-format tape file. 
Use the COPY command to convert the S-, L-, 
or F-format tape file to a mass storage 
file or to an I or SI binary format tape 
file before attempting to dump the file 
using TDUMP. 
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Format: 


TDUMP,pi,p2,...,Pn. 


Pi 

l=lfni 

L=lfn2 


H 

0 

A 


R=rcount 


Description 


Specifies the local file to be dumped (default is TAPEl). 

Specifies the local file to which the output is written (default is 
OUTPUT). If lfn 2 is not a local file, TDUMP creates it. It does 
not rewind lfn 2 before or after the dump. 

Specifies a hexadecimal dump. 

Specifies an octal dump. 

Specifies an alphanumeric dump. 

If more than one of the H, 0, or A parameters are specified, all the 
forms specified are produced. Each line of the dump is shown in octal 
(if 0 is specified), then in alphanumeric (if A is specified), and 
then in hexadecimal (if H is specified). If no H, 0, or A parameter 
is specified, TDUMP lists a combined octal and alphanumeric dinop, as 
if 0, A had been specified. 

Specifies the maximum decimal number of records to be dumped. If R is 
omitted or set to zero, the dump continues to EOI. 


NOTE 


The record count restarts at each EOF. 


F=fcount Specifies the maximum decimal number of files to be dumped. If F is 

omitted, the dump continues to EOI. If F=0, the dump continues until 
an empty file (double EOF) or EOI is encountered. 

N=lines Specifies the maximum decimal number of lines to be dumped. If N is 

omitted or set to zero, the dump continues to EOI. The blank line 
output with the end—of-record, end—of-file, end-of-information, and 
ABOVE LINE REPEATED messages is included in the line count. 

C Instructs the system to read file Ifn in coded mode rather than 

binary mode. 


NR 


Do not rewind file Ifni before the dump (default is to rewind 
Ifni). 


CW 


Specifies that control words as well as data are to be dumped. If CW 
is omitted, control words are not dumped. 


Example: 

Two lines, each containing the alphabet, were input to file X from an interactive terminal. 
File X was dumped to file Y producing the following output. 


- FILE DUMP - TDUMP,I=X,L=Y. 

F 1 R 1 « 0- 0102 0304 0506 0710 1112 

AB CD EF GH 1 J 
F 1 R 1 « 4- 1314 1516 1 720 2122 2324 

KL MN OP BR ST 

— END OF RECORD — 

— END OF INFORMATION — 

— END OF DUMP — 


yy/mn/dd. hh.nB.ss. PAK 1. 

1314 1 516 1 720 2122 2324 2526 2730 3132 0000 0000 0102 0304 0506 0710 1112 
ALMN0P8RST UVNXYZ ABCDEFGHIJ 

2526 2730 3132 0000 0000 
U V W X Y 2 
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File X was then dumped to file Y using the CW parameter, producing the following output. 
Note that when the CW parameter is used, EOR and EOF markers are dumped along with the data 
with no marked separation. 


- Flli DUMP - TDUMP,I>=X,L-Y,CH. yy/nai/dd. hh.nm.ss. PAGE 1. 


F 

1 R 1 W 

0- 0000 

0100 

0000 

0000 

0036 

0102 

0304 

0506 

0710 

1112 

1314 

1516 

1720 

2122 

2324 

2526 

2730 

3132 

0000 

0000 




A 



3 

A B 

C D 

E F 

G ii 

I J 

K L 

H N 

0 P 

Q R 

S I 

U V 

W X 

Y Z 



F 

1 R 1 W 

4- 0102 

0304 

0506 

0710 

1112 

1314 

1516 

1720 

2122 

2324 

2526 

2730 

3132 

0000 

0000 

0000 

0000 

0010 

4676 

0001 



A B 

C D 

E F 

G H 

I J 

K L 

H N 

0 P 

Q R 

S T 

U V 

V X 

Y Z 





H 

- 



— EM) OF INFORKATION — 

— END OF DDMP — 


File X was then converted to ASCIIS format tising FCOPY to create file AX. File AX was then 
dumped to file Y using the H parameter, producing the following output. 




- FILE DUMP 

- 

TDUMP, 

,I-AX, 

,L-Y,H. 








yy/m/dd. 

hh. 

.nra.ss 

. PAGE 

1. 

F 

1 R 

1 W 0-041 

042 

043 

044 

045 046 

047 

048 

049 

04A 

04B 

04C 

04D 

04E 

04F 

050 

051 

052 

053 

054 

F 

1 R 

1 W 4- 055 

056 

057 

058 

059 05A 

000 

000 

000 

000 

041 

042 

043 

044 

045 

046 

047 

048 

049 

04A 

F 

1 R 
END 

1 W 10- 04B 
OF RECORD — 

04C 

04D 

04E 

04F 050 

051 

052 

053 

054 

055 

056 

057 

058 

059 

05A 

000 

000 

000 

000 


— END OF INFOEMATION — 

— END OF DUMP — 


The prefix 

FIR 1 W 0 

means file 1, record 1, word 0. The zeros following each alphabet are the end-of-line 
indicators. 


UNLOAD COMMAND 

The UNLOAD command releases files assigned to the job and may release file space (depending 
on the file type). 

Format: 

UNLOAD,Ifni tlfn2 ,. •. jlfnjj. 
or 

UNLOAD,* ,lfni,lfn2,...,lfnji. 

Parameter Description 

Ifnj Specifies the name of a file assigned to your job. 

The first format unloads the named files (Ifni,lfn 2 ,...jlfnjj). second format unloads 

all files assigned to the job except the named files. If no files are named on the second 
format, the asterisk specification imloads all files assigned to the job. There are some 
exceptions. The UNLOAD command does not release any files that have checkpoint or no-auto- 
drop status. Certain system scratch files (for example, ZZZZZCO, ZZZZZCl, ZZZZZC2, and 
ZZZZZLD) have no-auto-drop status. You can give any local file this status by using the 
SETFS conmand. 
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The DKIOAD command performs the same function as the RETURN ccmmcuid except as noted below. 
Refer to the description of the RETURN conmatnd given earlier in this section to determine 
the operation performed for each file type. 


If the file being unloaded is a magnetic tape file or a direct access file residing on an 
auxiliary removable pack and the job requires more than one tape or pack concurrently, the 
UNLOAD command differs from the RETURN command. It does not decrease the number of tapes or 
packs that were scheduled for the job with the RESOURC command. If the file is a magnetic 
tape file and if the previous operation was a write, the following (derations are performed: 

• If the tape is ANSI-labeled, the system writes a tape mark, an EOFl label, and three 
tape marks and then unloads the tape. 

• If the tape is unlabeled and the data format specified on the ASSIGN, LABEL, or 

REQUEST command is S, L, or F, the system writes four tape marks and then unloads 
the tape. 

• If the tape is unlabeled and the data format is I, LI, or SI, the system writes a 
tape mark, an EOFl label, and three tape marks amd then unloads the tape. 

Refer to Magnetic Tape Files in section 2 and Tape Management commands in section 12 for 
further information about tape files, and to appendix G for a description of an EOFl label. 
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UNLOCK COMMAND 


The UNLOCK command rescinds the LOCK command and clears the write interlock for the 
specified file. This command can only be used on local mass storage files. 

Format: 


UNLOCK, If nj, If .If i^n* 

Parameter Description 

Ifni Specifies the name of a local file. 

Library files cannot be unlocked. 


VERIFY COMMAND 

The VERIFY command performs a binary comparison of all data from the current position of the 
files specified. The comparison is meaningful if the files are within the range of 
compatible formats listed in table 9-3. For output listing files not connected to your 
terminal, the VERIFY command honors the page length and print density set for your job using 
the SET command and the PL and PD symbolic names. 

Format; 


VERIFY,Ifni,lfn2,PI,P2,•..,Pn* 
Parameter 


Description 


Ifni Specifies the name of the first file; if this parameter is omitted, 

TAPEl is assumed. 

Ifn 2 Specifies the name of the second file; if this parameter is omitted, 

TAPE2 is assumed. 


Vj Optional parameters 

Pi Description 

N®x In the case of multifile files, specifies the number 

of files to verify. The default is N=l. 

If you specify just the keyword N, verification 
proceeds until the end of information is reached on 
both files. 

If you specify N=0, verification terminates whenever 
an empty file is encountered on either file. 

E*y Specifies the maximum number of errors to list. The 

default is E^IOO. Specifying E has the same effect as 
E=0. 

L»lfn 3 List errors on file lfn 3 . If L is omitted, the 

system assumes L>OUTPUT. 
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Description 


It 

A Abort after verification completed if errors occurred. 


R 


Rewind both files before and after the verification. 


C Set coded file node on both files. This is applicable 

only to S and L format tapes. If coded node is set on 
an SI tape, the system aborts the Job. 

Cl Set coded file mode on the first file only. This is 

applicable only to S and L format tapes. If coded 
mode is set on an SI tape, the system aborts the job. 


C2 Set coded file mode on the second file only. This is 

applicable only to S and L format tapes. If coded 
mode is set on an SI tape, the system aborts the job. 

BS=bslze Defines the maximum block size (PRU size) in central 
memory words for an S or L tape. This parameter is 
legal only for the verification of S and L tape 
verifies. The default for an S tape is lOOOg words, 
and for an L tape, it is 2000g words. 


Whenever words on Ifnj and lfn 2 do not match, the VERIFY command lists the following. 

• Record number. 

• Word number within the record. 

• Words from both files that do not match. 


I NOTE I 


When printing output for text files, VERIFY 
uses the first seven characters of the first 
word of the record as the record name. 
VERIFY assumes that the record is in 6-bit 
display code. Therefore, if you attempt to 
display VERIFY output for a record in 6/12- 
bit display code while your, terminal is in 
ASCII mode, the output display may be 
garbled. To avoid this problem, you should 
set your terminal to NORMAL mode before 
listing VERIFY output. 


In a verification involving S, L, or F format tapes, the VERIFY command first clears the 
extraneous data in the last word of each block (as specified by the byte count and the 
unused bit count) and then makes the comparison. On these formats, every block is 
considered a record (returns EOR status). 

If a verification of an L or F format tape requires additional field length, the VERIFY 
command increases the field length as needed. 

The maximum block size for an L format tape is specified by the BS-bslze or Its default. 

The maximum block size for an F format tape is calculated from the frame or character count 
specified on the command when the file is assigned. 
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Tctble 9-3. Cc»r^atible File Structures for the VERIFY Command 



SECOND FILE (lfn2) 

FIRST FILE 
{I=lfni) 

Hass 

Storage 

I Tape 
Format 

SI Tape 
Format 

S Tape 
Format 

L Tape 
Format 

F Tape 
Format 

LI Tape 
Format 

Hass Storage 

Yes 

Yes 

Yes 

No 

No 

No 

Yes 

I Tape Format 

Yes 

Yes 

Yes 

No 

No 

No 

Yes 

SI Tape Format 

Yes 

Yes 

Yes 

No 

No 

No 

Yes 

S Tape Format 

No 

No 

No 

Yes 

No 

No 

No 

L Tape Format 

No 

No 

No 

No 

Yes 

No 

No 

F Tape Format 

No 

No 

No 

No 

No 

Yes 

No 

LI Tape Format 

Yes 

Yes 

Yes 

No 

No 

No 

Yes 


NOTE 


The No entries indicate that the logical 
structures of the files coopared are 
inconpatible. The VERIFY commcind may accept 
those combinations, but the results require 
you to make a knowledgeable correlation of 
results with the format descriptions in 
section 12. In some cases, the verification 
of an inccmpatible pair may result in a 
VERIFY GOOD message; otherwise, a VERIFY 
ERRORS message is listed. 
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WRITEF COMMAND 


The WRITEF cranmaxid directs the system to write a specified nvimber of file marks on the named 
file. 

Format; 

WRITEF,lfn,x. 

Parameter Description 

Ifn Specifies the name of the file to be written on. 

X Specifies the number of filemaxks to be written. If this parameter is 

omitted, the system assumes x is 1. The maximum for x is 262143. 

If the last operation to the file was a write that did not end with the writing of an EOR or 
EOF, WRITEF writes a record mark before it writes the specified number of file marks. For 
all other cases, WRITEF writes the file marks without a preceding record mark. 


WRITER COMMAND 


The WRITER commcuid directs the system to write a specified number of en?3ty records on the 
named file. 

Format: 

WRITER,Ifn,X. 

Parameter Description 

Ifn 

X 


Specifies the nsime of the file to receive the empty records. 

Specifies the number of empty records to be written. If this 
parameter is omitted, the system assumes x is 1. The maximum for x is 
262143. 
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PERMANENT FILE COMMANDS 


10 


With permanent file commands, you can create, access, and purge permanent files* You can 
also control other users' access to your files. 


The following are the permanent file commands and their functions. 


Command 

APPEND 

ATTACH 

CATLIST 

CHANGE 

COMMON 

DEFINE 

DROPDS 


Function 

Appends data to an indirect access permanent file. 

Assigns a direct access permanent file to a job. 

Lists permanent file information. 

Changes permanent file characteristics. 

Accesses library type files. 

Creates a direct access permanent file. 

Releases the disk space associated with a permanent file for which a 
valid alternate storage copy exists. The local file copy (if any) is 
also returned. 


FTP 

GET 

MFLINK 

OLD 

PACKNAM 

PERMIT 

PURGALL 

PURGE 

RECLAIM 

REPLACE 

SAVE 

SETPFAC 

SETPFAL 


Provides file transfer capabilities between connected TCP/IP hosts. 

Retrieves a copy of an indirect access permanent file as a local file. 

Transfers a file from one mainframe to another or alters the attributes 
of a file on another mainframe. 

Retrieves a copy of an indirect access permanent file as the primary 
file. 

Specifies an auxiliary device from which permanent files are to be 
accessed. 

Grants permanent file access permission to other users. 

Purges all files having the specified characteristics. 

Purges the named files. 

Creates and manages tape and disk backup copies of permanent files. 
Copies a local file over an indirect access permanent file. 

Creates an indirect access permanent file. 

Changes the security access category set of a permanent file. 

Changes the security access level of a permanent file. 
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If an error occurs In an operation on one file of a multifile request, the operation is not 
performed on the subsequent files. For example, if an error occurs in the processing of 
file B on the following command: 

GET,A,B,C,D. 

files C and D are not processed. 

On a secured system, your job may not access a permanent file unless the job is validated 
for the access level and access category set assigned to the file. For an alternate user 
access, such an access attempt is treated as a file-not-found error; for an access to one of 
your own files, it is treated as a security conflict. 

In addition, your job may not change or access certain types of permanent file information. 
The following limitations apply: 

• CHANGE, PERMIT, and SETPFAC requests are not allowed on files with an access level 
lower than that of the job. 

• CATLIST requests for permit information are not allowed on files with an access 
level higher than that of the job. Normal CATLIST requests are allowed, but 
Information on the password expiration date and access category set is not included 
in the CATLIST output. If a password exists, it is returned as seven asterisks 

^ it'kic'kic'k’k ) ^ 

For more information on permanent files, refer to Permanent Files, Mass Storage File 
Residence, and Alternate Storage in section 2. 

To determine the meaning of a permanent file error message, refer to appendix B. 


COMMON PARAMETERS 

Some permanent file commands can process several files. Each file is identified by a one- 
to seven-character file name. The permanent file operation is performed on each file in the 
sequence specified on the command. If the NA parameter is not specified on the command and 
an error occurs while one of the files is being processed, the job step terminates. 

When this happens, the files preceding the file in error are processed, but the files 
succeeding it are not. If the NA parameter is specified on the command, the job step does 
not terminate as a result of the error, and all files are processed except the file in error. 

When a slash is used, it separates the file names from other parameters. The parameters 
specified after the slash are optional and order independent. Parameters specified after 
the slash affect all files named before the slash. 

Permanent file access is controlled by the permit category (CT), user name (UN), file access 
password (PW), security access level (AL), and access mode (M) parameters. Permanent file 
residence is determined by the preferred residence (PR), auxiliary device (PN), and device 
type (R) parameters. Processing options include the no abort (NA), wait-if-busy (WB), 
subsystem selection (SS), and backup copy (BR) parameters. 
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In the following list, parameters common to more than one permanent file command are 
described in alphabetic order. For the format of each command, refer to the command 
descriptions following the parameter descriptions. 


Parameter 


AL=level 


BR=br 


Description 

Specifies the security access level you want assigned to the file. 
Unless changed by your site, level can be one of the following names 

LVLO, LVLl, LVL2, LVL3, LVL4, LVL5, LVL6, or LVL7 

When used with the DEFINE command, the default for this parameter is 
the current job access level. When used with the SAVE command, the 
default is the access level of the local file being saved. 

Specifies the backup copy requirement. You can request that two 
backup copies, one backup copy, or no backup copy be kept of your 
permanent file. Depending on your site's configuration and 
procedures, a backup copy can be one of the following: 

• A cartridge alternate storage (MSE) copy. 

• A tape alternate storage copy. 

• A tape alternate storage secondary copy. 

• A PFDUMP tape copy. 

The following values can be specified for br: 

Backup Requirement 

Two backup copies of the file must be kept. 

One backup copy of the file must be kept. 

No backup copy of the file need be kept. 

H DR“hr is omitted, BR=Y is used by default. For more information, 
refer to Alternate Storage in section 2. 


br 

Y 

MD 

N 
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Parameter 


Description 


CT=ct Specifies the file permit category. If CT=ct is omitted when the file 

is created, the file is private. The file category can be changed 
later. 

ct Category 

P, PR, or PRIVATE Private files; available for access only 

by their creator and by those granted 
explicit access permission by the file 
creator (refer to the PERMIT command). 

For each permitted user, the system 
records the number of accesses made and 
the date and time of the last access by 
each user. This information may be 
displayed with the CATLIST(LO=FP) command. 

The system also records the total number 
of accesses by all users, the date and 
time of the last access by any user, and 
the date and time of the last modification 
by any user. This information may be 
displayed with the CATLIST(LO=F) command. 

S or SPRIV Semiprivate files; available for access by 

any user who knows the file name, user 
name, and password. The file owner 
specifies the default permitted mode of 
access for all users. The file owner may 
also specify different permissions for 
different users with the PERMIT command. 

For each user who accesses the file, the 
system records the user name, the number 
of accesses made, and the date and time of 
the last access. This information may be 
displayed with the CATLIST(LO=FP) command. 

The system also records the total number 
of accesses by all users, the date and 
time of the last access by any user, and 
the date and time of the last modification 
by any user. This information may be 
displayed with the CATL1ST(L0=F) command. 
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Parameter 


Description 


£t Category 

PU or PUBLIC Public files; availcUsle for access by all 

users who know the file ncune, user name, and 
password. The file owner specifies the 
default permitted mode of access for all 
users. The file owner may also specify 
different permissions for different users with 
the PERMIT command.' 

For each explicitly permitted user, the system 
records the number of accesses made cuid the 
date and time of the last access. This 
information may be displayed with the 
CATLIST (I,0=FP) command. 

The system also records the total number of 
accesses by all users, the date and time of 
the last access by any user, and the date and 
time of the last modification by any user. 

This information may be displayed with the 
CATLIST{LO=F) command. 

NA Specifies the no eibort option. Normally, an error in command 

processing terminates the job. However, if NA is specified, the job 
does not terminate as a result of the error. The error is handled in 
one of two ways. 

• If the error condition is tenporary, job processing is 
suspended until the error condition ends (for example, when a 
requested direct access file is busy or a requested axuciliary 
device is not available) . In a multimainframe environment, 
job processing may be suspended until some period after the 
error condition ends. 

• If the error condition is not tenporary, the job continues 
with the next qperation. The job processes the next file 
listed on the command or, if no more files are listed, 
processes the next command. 

You may not specify both the NA and HB parameters. 

PN=packname Specifies the 1- to 7-character pack name used in conjunction with the 
R parameter to identify the auxiliary device to be accessed in the 
permement file request. This parameter is specified only when the 
file to be accessed resides on an auxiliary device. 

An auxiliary device is a mass storage device that supplements the 
normal feunily of permanent file devices. A RESOORC cooanand must be 
included in any job that concurrently uses two or more atixiliary disk 
packs or an auxiliary pack and a magnetic tape. 

If you specify PN=0 on a permanent file command, it overrides any 
previously issued PACKNAH commands. You can then access files on the 
permanent file family device. PN=0 does not affect siobsequent 
commands, only the current command. 
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Parameter 


Description 


PR=pr 


Specifies the preferred residence. If PR=pr is cmiitted, no preference 
is assumed. For more information, refer to Alternate Storage in 
section 2. 


or Preference 

D You prefer that the file remain on disk between accesses. 

However, the system might move the file to alternate 
storage despite the specified preferred reference. 

L The file is locked to disk euid will not be moved to 

alternate storage. Special validation is required to 
specify this value. 

M You prefer that the file be moved to MSB or optical disk 

between accesses. However, the system might not move the 
file to MSB or optical disk despite the specified 
preference. 

K You have no preference. 

T You prefer that the file be moved to tape alternate 

storage between accesses. However, the system might not 
move the file to tape alternate storage despite the 
specified preference. 


PWspassword Specifies the 1- to 7-character file password. If a password is 

assigned to the file, users other than the file creator must specify 
the password when accessing the file. 


If only the keyword PH is specified, you must include the password as 
a single-line record in the it^ut file. In a interactive job, the 
password is requested by a ? proopt at the terminal. 

R=r Specifies the device type on which the file resides or is to reside. 


DBi 

DCi 

DDi 

DB 

DFi 

DGi 

DHi 

Dli 

DJi 


Device 

885-42 Disk Storage Subsystem (l<.i<3) . 

895-1/2 Disk Storage Subsystem (l<i<2). 

834 Disk Storage Subsystem (l<i<8). 

Extended memory. 

887 Disk Storage Subsystem (l<i<3; 4K sector) . 

836 Disk Storage Subsystem (l£i<3) . 

887 Disk Storage Subsystem (l<i<2; 16K sector). 

844-21 Disk Storage Subsystem (l<i<8; half-track). 

844-41 or 844-44 Disk Storage Siibsystem (l<i<8; 
half-track). 
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Parameter 


Description 


r 

DKi 

DLi 

DMi 


Device 

844-21 Disk Storage Subsystem (l<i<8; full-track). 

844-41 or 844-44 Disk Storage Subsystem (l<i<8; full- 
track) . 

885-11/12 Disk Storage Subsystem.(l<i<3; half-track). 


DN 

DQi 

Dpt 

DV 

DW 

EAi 

EBi 

ECi 

EOi 

EE 

EF 


9853 Disk Storage Subsystem. 


885-11/12 Disk Storage Subsystem (l<i<3; full-track). 
Distributive data path to extended memory. 

819 Disk Storage Subsystem (single-density). 

819 Disk Storage Si:ibsystem (double-density) . 


5830 Disk Array Subsystem; one 5832 SSD drive used in 
serial mode (l<i<^8) . 

5830 Disk Array Subsystem; two 5832 SSD drives used in 
parallel mode (l<i<6). 


5830 Disk Array Stibsystem; one 5833 SABRE drive used in 
serial mode (l<i<2). 


5830 Disk Array S'ubsystem; two 5833 SABRE drives; one for 
data and one for parity (l<i<2) . 


5830 Disk Array Sxjbsystem; two 5833 SABRE drives used in 
parallel mode. 


5830 Disk Array Subsystem; three 5833 SABRE drives: two 
for data and one for parity. 


The value i denotes the number of units (spindles) required for a 
P^^ticular auxiliary disk file that you will access in your job. 

The R parameter can be specified on any permanent file command to 
identify (along with the PN parameter or with a previous PACKKAM 
command) the auxiliary device on which the permanent file resides. R 
is specified only if the installation defines the auxiliary device as 
removable, auid if the desired device type differs from the 
installation-defined default device type. R is not required if a 
previous PACKKAM conmand specified the R parameter. If the R 
parameter is specified without the PN parameter in a command, R is 
ignored on all commands except the DEFINE command (refer to the DEFINE 
ccMnmand in this section) . 


t The job must be of system origin or you must have 


system origin privileges. 


60459680 P 


10-4.3/10-4.4 




Parameter 


Description 


SS=subsystem 


UN=nisername 


Specifies the interactive subsystem to be associated with the file. 

The subsystem can be specified on a SAVE or CHANGE command with one of 
the following entries or its abbreviation (the abbreviation is the 
first three characters of the entry). 


subsystem Interactive Subsystem 


BASIC 

BASIC 


BATCH 

Batch 


EXECUTE 

Execute 


FORTRAN 

FORTRAN 

5 

FTNTS 

FORTRAN 

Extended 4 

NULL 

Null 



If the SS keyword is specified without a subsystem, the currently 
active subsystem is associated with the file. If the SS keyword is 
omitted, no subsystem (null) is associated with the file, unless the 
file is the primary file. In that case, the currently active 
subsystem is associated with the file. 

Specifies the user name. This parameter must be specified if the 
requested permanent file is in another user's catalog. To access the 
file, you must have one of the following permissions. 

• Explicit permission. The owner of the file granted access 
permission to the user with a PERMIT command. 

• Implicit permission. The file is semiprivate or public and so 
can be accessed by users who know the file name, user name, 
and password and who have not been explicitly denied 
permission. 

• Automatic permission. You have automatic permission to access 
files in the catalog of another user if your user name 
contains asterisks, and if all nonasterisk characters match 
characters in the other user's user name. 

The UN keyword establishes alternate access validation, unless the 
specified user name is the one under which the job is currently being 
run. In this case, the specified user name is ignored. 
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Parameter 


Description 


WB Specifies the wait-if-busy option. WB causes the job to wait for busy 

files and the mounting of disk packs but to abort on other error 
conditions. You may not specify both the NA and WB parameters. 

XD=expiredate Specifies the expiration date for a file password or file permit. Die 
value expiredate must be a six-digit string of the form yymmdd; where 
yy, mm, dd are two-digit year, month, and day designators, 
respectively. The latest date you can specify and the default 
expiration date are site-determined. 

You must have special authorization to specify an expiration date for 
a file password or permit (refer to the LIMITS command). 

Xr=expireterm Specifies the life of a file password or permit in days. If you 

specify 0, the file password or permit expires immediately. If you 
specify 4095 or *, the file password or permit does imt expire. The 
default expiration term and the maximum expiration term are 
site-determined (no site can choose a value greater than 4095, 
however). 

You must have special authorization to specify an expiration term for 
a file password or permit (refer to the LIMITS command). 
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APPEND COMMAND 


The APPEND conanand adds Information to the end of an existing indirect access file without 
retrieving the file. The APPEND command cannot append data to direct access files. 

Format: 


APPEND,pfn.lfnj^ ,lfn 2 ,...,lfn^/UN-username, PW=password,PN=packname,R=r,NA,WB. 

Parameter Description 

pfn Specifies the name of the indirect access permanent file to which data 

is appended. You do not retrieve the indirect access file before the 
append operation, but you must have permission to access the file in 
append, modify, or write mode. 

If a local copy of the indirect access file is assigned to the job, 
the append operation does not change the local copy. 

If^i Specifies the name of a local mass storage file to be appended to 

pfn. The file must be assigned to the job. 

The full descriptions of the following optional parameters are given at the beginning of 
this section. 


Parameter 


Description 


UN=username Specifies the user name. Specified if pfn is in another user's 
catalog. 

PW^password Specifies the file password. Specified if UN=username is specified 
and pfn has a password. 


PN=packname Specifies the auxiliary device name. Specified if pfn resides on an 
auxiliary device. 


Specifies the device type. Specified if a removable auxiliary device 
on a device type other than the installation-defined default is to be 
used. 


NA Specifies the no abort option. If NA is specified, processing errors 

do not terminate the job. 

WB Specifies the wait-if-busy option. WB causes the job to wait for the 

mounting of disk packs. 

The logical structure of the files is retained; that is, EORs and EOFs are appended as well 
as data. The append operation removes the EOI mark at the end of file pfn, but keeps all 
EOR and EOF marks. 
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ATTACH COMMAND 

The ATTACH command assigns a direct access permanent file to a job. 
Format: 


ATTACH,Ifn.=pfn. ,lfn_=pfn„,...,lfn =pfn /M=m,UN=username,FW=password, 
PN=packname,Rir,NA7RT,WB. “ ” 


Parameter Description 

lfni=pfnj^ Specifies that the one- to seven-character file name Ifn^ references 
direct access file pfn^ while the file is assigned to the job. If 
lfn£= is omitted, the direct access file is referenced by its 
permanent file name, pfn^. User access is directly to the permanent 
file; no working copy is generated. 

If local file Ifn^ exists when this command is processed, the file 
returned (even if command processing does not complete due to an 
error). 


The full descriptions of the following optional parameters (except M=m and RT) are given at 
the beginning of this section. 

Parameter Description 


M=m 


File access mode requested. If M=m is omitted, M=READ is assumed. 


If m is: 

You can: 

Concurrently, other users 

can: 

E or EXECUTE 
(execute mode) 

Execute the file. 

Read 

or execute the file. 


R or READ 
(read mode) 

Read or execute 
the file. 

Read 

or execute the file. 


RU or READUPt 

Read or execute 

Read 

or execute the file; 

one 

(read update 
mode) 

the file 

user 

can rewrite the file. 


RA or READAPt 

Read or execute 

Read 

or execute the file; 

one 

(read append 
mode) 

the file. 

user 

can lengthen the file 

• 

RM or READMDt 

Read or execute 

Read 

or execute the file; 

one 

(read modify 
mode) 

the file. 

user can lengthen or rewrite 
the file. 


t Special care should be taken when using modes RM, RA, or RU. Some programs do not 
anticipate that one user may be updating a file while other users are reading the same 
file. Specifically, CRM/AAM (refer to the CYBER Record Manager Advanced Access Methods 
Reference Manual) is not designed to handle concurrent reading and updating. If a program 
using CRM/AAM attempts to access a file attached in RM, RA, or RU mode while a second 
program using CRM/AAM is accessing the file in M, A, or U mode, one or both programs may 
be aborted with an error message stating that the file was ruined. In fact, the file may 
still be intact, but CRM cannot guarantee this and does not allow the access. 
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Parameter 


Description 


If m is: 

You can: 

Concurrently, other 

users can: 

U or UPDATE 
(update mode) 

Read, execute, or 
rewrite the file. 

Read 

or execute the 

file. 

A or APPEND 
(append mode) 

Read, execute, or 
lengthen the file. 

Read 

or execute the 

file. 

M or MODIFY 
(modify mode) 

Read, execute, 
lengthen, or re¬ 
write the file.'t 

Read 

or execute the 

file. 

W or WRITE 
(write mode) 

Read, execute, 
lengthen, rewrite, 
or shorten the 
file. 

No access allowed. 


cannot change 

the file unless you 

attach 

it in update, 

append, 


modify, or write mode. Refer to table 10-1 for the access mode 
granted when the file is already attached by another user. 

If the file is attached in update, append, modify, or write mode, the 
current date is recorded as the last modification date even if the 
file is not altered. 


UN=username Specifies the user name. Specified if the permanent file(s) is in 
another user's catalog. 

PW=password Specifies the file password. Specified if UN=username is specified, 
and if the permanent file has a password. 

PN«packname Specifies the auxiliary device name. Specified if the permanent 
file(s) resides on an auxiliary device. 


R=r Specifies the device type. Specified if a removable auxiliary device 

on a device type other than the installation-defined default is used. 

NA Specifies the no abort option. If NA is specified, processing errors 

do not terminate the job; the job also waits for the mounting of disk 
packs and busy files. 


RT Specifies the real-time processing option. If RT is specified, the 

job continues processing after requesting staging of a file from 
alternate storage to disk. If staging is not required (the file is 
already resident on disk), the file is assigned to the job. If the 
file must be staged, you must issue a second ATTACH command to assign 
the file to the job. 


If RT is omitted and the file resides only on alternate storage, job 
processing is suspended while the file is staged to disk and assigned 
to the job. For more information on alternate storage, refer to 
Alternate Storage in section 2. 


tyou cannot rewrite the file using the copying commands described in section 9. To rewrite 
the file while in modify or update mode, you must write your own program using the REWRITE 
macro (refer to Volume 4, Program Interface). 


60459680 J 


10 - 8 . 1 / 10 - 8.2 




Parameter 


Description 


WB Specifies the wait-if-busy option. WB causes the job to wait for the 

mounting of disk packs auid busy files. 

If an auxiliary device has been previously specified by a PACKNAM command, the system 
atten^ts to find pfn^ on the auxiliary device rather than on a family device. 

In the first column of table 10-1 is the access mode in which the first user attached a 
direct access file. The remaining columns are the access modes that may be requested by 
another user. At the intersection of the row cind column is the access mode greuited to the 
other user (assuming the user has the appropriate access permission). Busy meains that the 
other user is sent a message that the file is busy, and the job step is aborted unless HA or 
WB is specified. 

Assuming that no user has the file attached in append, update, modify, or write mode, 16380 
users can attach the file concurrently (4095 in read mode, 4095 in read append mode, 4095 in 
read update mode, and 4095 in read modify mode). If a user has the file attached in append 
mode, 8190 other users can attach the file (4095 in read append mode and 4095 in read modify 
mode). If a user attaches the file in update mode, 8190 other users can attach the file 
(4095 in read update mode and 4095 in read modify mode). If a user has the file attached in 
modify mode, 4095 other users can attach it in read modify mode. If a user has the file 
attached in write mode, no other user can attach the file. 


Table 10-1. Access Mode Granted When Attaching a Currently Attached Direct Access File 


Mode in Which 

First User 

Attached File 

Write 

Access Mode Requested by Another User 

Modify Append Update Read Read Modify 

Read Append 

Read Update 

Execute 

Write 

Busy 

Busy 

Busy 

Busy 

Busy 

Busy 

Busy 

Busy 

Busy 

Modify 

Busy 

Busy 

Busy 

Busy 

Busy 

Read Modify 

Busy 

Busy 

Busy 

Append 

Busy 

Busy 

Busy 

Busy 

Busy 

Read Modify 

Read Append 

Busy 

Busy 

Update 

Busy 

Busy 

Busy 

Busy 

Busy 

Read Modify 

Busy 

Read Update 

Busy 

Read 

Busy 

Busy 

Busy 

Busy 

Read 

Read Modify 

Read Append 

Read Update 

Execute 

Read Modify 

Busy 

Modify 

Append 

Update 

Read 

Read Modify 

Read Append 

Read Update 

Execute 

Read Append 

Busy 

Busy 

Append 

Busy 

Read 

Read Modify 

Read Append 

Read Update 

Execute 

Read Update 

Busy 

Busy 

Busy 

Update 

Read 

Read Modify 

Read Append 

Read Update 

Execute 

Execute 

Busy 

Busy 

Busy 

Busy 

Read 

Read Modify 

Read Append 

Read Update 

Execute 
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CATLIST COMMAND 


The CATLIST command lists information about your permanent files or the permanent files you 
can access in the catalogs of other users. For interactive terminals operating in screen 
mode, the system automatically reformats CATLIST output according to the page length set for 
your terminal. 

Format: 

CATLIST,DN=dn,EF=ef,FN=fn,L=lfn,LO=option,NA,PN=packname, R=r,RS=rs,TY=ty,UN=username, WB. 
Parameter Description 

DN=dn Specifies the device number assigned to a device at system 

initialization. If specified, the CATLIST command lists catalog 
information from that device. 

Specifies one or more excluded permanent file names. This parameter 
excludes these permanent files from being listed. 

An asterisk {*) present in a file name indicates that a set of files 
is to be excluded. For example, EF=***OPL will exclude all the files 
with 6-character file names that end in OPL; ef=M****** will exclude 
all the files with file names that start with the letter M. 

Multiple file names may be specified, separated by slashes. For 
example, EF=A******/B******/C****** will exclude all the files with 
names that begin with the letters A, B, or C. 

The EF parameter may be specified together with the FN parameter. For 
example, FN=AB*****,EF=ABC**** will list information about all files 
with names that start with the letters AB, except for those files with 
names that start with the letters ABC. 

This parameter is not allowed when listing permit information (LO=FP, 
LO=P), nor when listing security access categories (LO=X). 
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Parameter 


Description 


FN=fn 


L=lfn 


Specifies one or more permanent file names. This parameter specifies 
that catalog information is to be listed only for these permanent 
files. 

An asterisk (*) present in a file name indicates that information for 
a set of files is to be listed. For example, FN=***OPL will list all 
the files with 6 character file names that end in OPL; FN=M****** will 
list all the files with file names that start with the letter M. 

Multiple file names may be specified, separated by slashes. For 
example, FN=A******/B******/C****** will list all the files with names 
that begin with the letters A, B, or C. 

The FN parameter may be specified together with the EF parameter. For 
example, FN=AB******,EF=ABC**** will list information about all files 
with names that start with the letters AB, except for those files with 
names that start with the letters ABC. 

If a single file name with no asterisk (*) characters is specified 
together with L0=0, a message (fn FOUND.) indicates whether or not the 
specified file is found in the specified catalog. If such a file namo 
is specified together with LO=P and UN=username, a message (username 
FOUND.) indicates whether or not permission to access that file has 
been granted to that user name. 

This parameter is required when listing permit information (LO=FP, 
LO=P) or security access categories (LO=X). When LO=FP, LO=P, or LO=X 
is specified, only a single file name can be specified and no asterisk 
(*) characters can be used. 

Specifies the output file name. Ifn is the name of the file assigned 
to the job on which CATLIST information is written. If L=lfn is 
omitted, the system assumes L=OUTPUT. 

Ifn is not rewound before or after the CATLIST operation. 
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Parameter 


Description 


LO=option One of the following list options. If LO is omitted, L0=0 is assumed, 
option Description 


F Lists detailed information about the file specified by 

the FN=f'n parameter. If you do not specify an FN=fn 
parameter, the system lists information about each file 
in your catalog. An example of this list option is 
given following the parameter descriptions. 

If you specify an alternate user name (UN=username), you 
receive a listing of files you can access in the other 
user's catalog; however, the only files listed are those 
that the owner has explicitly permitted to be listed 
(using the AC parameter on a CHANGE, DEFINE, or SAVE 
command). The passwords for files in another user's 
catalog are not listed. Passwords must be obtained from 
the file owner. In addition, charge and project number 
information also is not listed in an alternate user 
CATLIST unless the calling user has system origin 
privileges. 

FP Lists the access permissions granted for the file 

specified on the FN=fn parameter. If a user name is 
also specified (UN=username), only the file permission 
granted to that user is listed. 

The user name, mode of permitted access, permission 
expiration date, number of accesses, and the date and 
time of the last access is listed for each user that has 
been granted explicit permission to access the file. 

For a semiprivate file, this information is also listed 
for all other users that have accessed the specified 
file. (User names are not recorded for accesses to 
public files.) An asterisk follows the user 
name/permission mode if explicit permission has been 
granted to this user. 
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Parameter 


Description 


option 

P 


X 


0 (zero) 


Description 

Lists the user names of users who have been grauited 
esqjlicit permission to access the specified file. For a 
semiprivate file, this option also lists the user names 
of all other users who have accessed the specified file. 
This option requires that a file name be specified 
(FN=fn). 


Lists the security access categories associated with the 
file specified on the FN=fn parameter as well as the 
information returned by the LO=F pareuneter. You must 
specify the FN=fn parameter if you specify IiO=X. 

For security reasons, the security access categories 
associated with a file will not be listed unless your 
current job security access level is at least as high as 
the current permanent file security access level of the 
file. Refer to the Security Features topic in section 3 
of this meinual for more information on security access 
levels and categories. 

Lists alphabetically the names of the indirect access 
files auid direct access files in your catalog. If you 
specify a user name (DN=usemame) , you receive a list of 
the files you can access in the other user's catalog. 

A file name surrounded by parentheses indicates that the 
file resides on alternate storage rather than on dish. 

An asterisk preceding a file name indicates an error 
status is set in the catalog entry for the file. The 
cause of the error may be one of the following: 

• EOI was altered during mass storage recovery. 

• Error exists in file data or permit entries. 

To clear an error status flag, refer to the CHANGE 
command in this section. 
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Parameter 


Description 


NA Specifies the no abort option. If HA is specified, processing errors do 

not terminate the job. Do not specify both NA and WB. 

PN=packname Specifies the auxiliary device name. This parameter specifies that CATLIST 
should use the catalog information on the named auxiliary device. 

Specifies the device type on which the permanent file catalog resides. R=r 
is used with the PN and NA parameters (refer to the R parameter description 
at the beginning of this section). 

Specifies by residence which files to list. If you do not specify an RS=rs 
parameter, all permanent files that meet the other specified criteria are 
listed. You may specify any combination of the following residence 
selections. Possible values are: 

rs Description 

C Lists files that reside on cartridge alternate storage (MSE or 
optical disk). These files may also reside on other media (disk 
and/or tape alternate storage). 

D Lists files that reside on disk storage. These files may also 
reside on other media (cartridge alternate and/or tape alternate 
storage). 

T Lists files that reside on tape alternate storage. These files may 
also reside on other media (disk and/or cartridge alternate 
storage). 

TY=ty Specifies by file type which files to list. If you do not specify a TY=ty 

parameter, all permanent files that meet the other specified criteria are 
listed. You may specify any combination of the following file type 
selections. Possible values are: 

ty Description 

A Lists both direct access files and indirect access files. 

D Lists direct access files. 

I Lists indirect access files. 

UN=usemame Specifies the user name. This parameter has two purposes: 

• For list options LO=F and LO=0, it specifies the alternate catalog 
for which you desire catalog information. 

• For list options LO=FP and LO=P, it requests the permission 
information recorded for the specified alternate user. 

When the short list options, LO=0 and LO=P, are specified, a message 
informs you whether or not the file or user name has been found. 

WB Specifies the wait-if-busy option. WB causes the job to wait for the 

mounting of disk packs. Do not specify both NA and WB. 
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Exanple 1: 


Listing of files in the catalog of STDDENT. The ccanmand is entered by user STUDEHT in the 
form; CATLIST (it is not necessary to specify the li0=0 option since it is the default 
value). 

CATALOG OF STUDENT FH/NOSCLSH yy/mn/dd. hh.om.ss. 

INDIRECT ACCESS FILES 

ADD (EXAM) GRADES ID HOOIFY2 (RESEQ) XX 

CAPITAL FIND ‘HEROFTN LIST PRIME T 

DIRECT ACCESS FILES 

CDIRFILE) DRFILE TV 

11 INDIRECT ACCESS FILES ON DISK. TOTAL PROS = 14. 

2 DIRECT ACCESS FILES ON DISK. TOTAL PROS = 2. 

2 INDIRECTS ON ALTERNATE STORAGE. TOTAL PROS = 2. 

1 DIRECT ON ALTERNATE STORAGE. TOTAL PROS = 2. 

An asterisk preceding a file nctme indicates that the error flag is set. A file name 
surrounded by parentheses indicates that the file resides on alternate storage rather than 
on disk. 


Exanple 2; 

Listing of files that begin with the letters PRCX: in the catalog of FREE007. The command is 
entered by user FREE007 in the form: CATLIST,FN=PROC***. 


CATALOG OF FREE007 FM/NOSCLSK yy/nm/dd. hh.nni.ss. 

FILE NAME PROC*** 

INDIRECT ACCESS FILES 

PROCART PROCFIL PR0C1 PR0C1A 

4 INDIRECT ACCESS FILES ON DISK. TOTAL PRUS = 15. 
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Exan^le 3: 


Listing o£ files with 6-character and 7-character file names that end in BIN in the catalog 
of xyZ3320. The command is entered by user xyZ3320 in the form: CATLIST, FN=***BIN/****BIK. 

CATALOG OF XYZ3320 FH/NOSCLSH yy/mn/dd. hh.mn.ss. 

SELECTED FILES 

DIRECT ACCESS FILES 

CATLBIN PFA5BIH PFTBIN PL14BIN PURGBIN QACBIN SPFLBIN 

NAGBIN PFA6BIN PL13BIN 

10 DIRECT ACCESS FILES ON DISK. TOTAL PROS = 390. 


Exan^le 4: 

Listing of files with 6-character and 7-character file names that end in BIN, except for 
those files with names that start with PF, in the catalog of xyZ3320. The ccxnmand is 
entered by user XYZ3320 in the form: CATLIST,FN=***BIN/****BIN,EF=PF*****. 

CATALOG OF XYZ3320 FH/NOSCLSH yy/nn/dd. hh.mn.ss. 

SELECTED FILES 

DIRECT ACCESS FILES 

CATLBIN HAGBIN PL13BIN PL14BIN PURGBIN QACBIN SPFLBIN 
7 DIRECT ACCESS FILES ON DISK. TOTAL PROS = 269. 


Example 5: 

Listing of alternate users that have accessed file PRIME in the catalog of STUDENT. The 
command is entered by user STUDENT in the form: CATLIST,LO=P,FN=PRIME. 


CATALOG OF STUDENT FH/NOSCLSH yy/im/dd. hh.nn.ss. 

FILE NAHE PRIHE 
USER NAMES 

CHK2011 JLX2015 KXK4277 

3 USERS 
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Exaople 6: 


Listing of detailed information about files in the catalog of SMITH. The coasnand is entered 
by user SMITH in the form: CATLIST,LO=F. 

CATALOG OF SMITH FM/NOSCLSH y//mn/dd. hh.RIS.SS. PAGE 1 

FILE NAME FILE TYPE LENGTH ON CREATION ACCESS DATA MOO 

PASSWORD COUNT PERM. SUBSYS DATE/TIME DATE/TIME DATE/TIME 

EXPIRES LEVEL PR BR AC RS 
CHARK NO. PROJECT NUMBER 

1 CATX IND. PRIVATE 1 84/04/19. 84/04/20. 84/04/19. 

1 READ 09.10.23. 08.30.16. 09.10.23. 

LVLO N Y N D 

2222 PRJ2201 

2 TESTLIB DIR. PUBLIC 1 41 84/04/19. 84/04/19. 84/04/19. 

0 WRITE 09.11.05. 09.11.05. 09.11.05. 

LVLO N Y Y 0 

2222 PRJ2201 

1 ItOIIRECT ACCESS FILE ON DISK. TOTAL PRUS = 1. 

1 DIRECT ACCESS FILE ON DISK. TOTAL PRUS = 1. 


Example 7: 

Listing of detailed information about the file XFILE, as well as listing of the security 
access categories associated with the file XFILE. the command is entered by user HLSOSBR in 
the form: CATLIST,FN=XFILE,LO=X. 

CATALOG OF MLSUSER FM/NOSCLSH yy/mn/dd. hh.im.ss. 

FILE NAME FILE TYPE LENGTH DN CREATION ACCESS DATA NOD 

PASSWORD COUNT PERN. SUBSYS DATE/TINE DATE/TIME DATE/TIME 

EXPIRES LEVEL PR BR AC RS 
CHARGE NO. PROJECT NUMBER 

1 XFILE DIR. PRIVATE 212 * 88/02/25. 88/02/25. 88/02/25. 

45 READ 11.11.48. 11.11.48. 11.11.48. 

LVL3 N Y N D 
1280 73CW5770 

FILE ACCESS CATEGORY SET 

CATOO CAT01 CAT02 CAT04 CAT06 
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Column headings are printed when the IiO=F or IjO=X parameter is specified. For CATLIST 
listing files not connected to a terminal, you can control the print density cuid page length 
using the SET command euid the PL and PD symbolic names. 


The following are the column headings euid their mecuiings. 


Heading 
FILE NAME 
FILE TYPE 

LENGTH 

DN 

PASSWORD 


Meaning 


Permanent file name. 


The permanent file type, direct access (DIR) or indirect access (IND), 
followed by the file permit category (PRIVATE, SPRIV, or PDBLIC). 

Length of the file in decimal PRUs. 

Device number of the mass storage device on which the direct access 
file is stored. If the file resides on the master device, this field 
contains cin asterisk. 

File password. It is not listed if the file belongs to another user. 
If the system is a secured system and if the file has an access level 
higher than that of your job, a series of seven asterisks (***♦***) 
replaces the file password. 


COUNT 


The number of times the file has been accessed. 


PERM. 

SUBSYS 


CREATION 
DATE/TIME 


Peinnission mode allowed the user. The entry is WRITE, KDDIFY, APPEND, 
UPDATE, READ, READMD, READAP, READOP, EXECUTE, or NULL. 

Interactive subsystem associated with the file. The possible entries 
are FORT., FTNTS, BASIC, EXEC., and BATCH. If this field contains no 
entry, a svibsystem is not associated with the file (null). 

File creation date and time in the following format. 

yy/mm/dd. 
hh.mm.ss. 


ACCESS 

DATE/TIME 

DATA MOD 
DATE/TIME 

EXPIRES 


LEVEL 


PR 


Date and time of the last access to the file. 


Date and time of the last modification of the file data. 


The eiq^iration date of the file password. It is not listed if the 
file does not have a password, the password does not ej^ire, or if the 
file belongs to another user. 

The security access level of the file. On a secured system, it is 
always listed if the file belongs to you. On an unsecured system, it 
is only listed if the level is not null (an assignment has been made) 
and the file belongs to you. 

Preferred residence for this file. The possible values are L, D, M, 

N, and T. For more information, refer to the description of the PR 
parameter at the beginning of this section. 
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Heading 

BR 


AC 


RS 


CHARGE NO. 


Meaning 

Requested backup copy for this file. Y means tape backup, MD 
means alternate storage or tape backup, and N means no backup 
required. For more information, refer to the description of the 
BR parameter at the beginning of this section. 

Alternate CATLIST permission. Specifies whether alternate users 
may obtain information about the file using CATLIST. Y means that 
information on this file will appear in an alternate user's 
CATLIST display; N meiuis that an alternate user cannot get 
information on this file. 

Actual residence of the file. The possible values are D, DC, DT, 
DCT, CT and T. If a D is present, a copy of the file exists on 
disk. If a C is present, a copy of the file exists on cartridge 
alternate storage (l^B or optical disk). If a T is present, a 
copy of the file exists on tape alternate storage. For more 
information, refer to Alternate Storage in section 2. 

Charge number associated with the file. 


PROJECT NUMBER Project number associated with the file. 


CHANGE COMMAND 


The CHANGE command changes certain characteristics of a permanent file. The file need not 
be assigned to the job. 

Format: 

CHANGE,nfn 3 _sOfn]^,nfn 2 °ofn 2 , . .. ,nfnjj=ofnjj/PW=paB8word,CT=ct,M=m,BR=br,PR!=pr, 

SSssubsystem, PNxpackname, R=r, NA, CE ,NB,XD=e3q)iredate ,XTsexpireterm, AC=ac, CP. 

Parameter Description 

nfn^sofn^ Specifies the file neune nfn^ replaces old permanent file name ofn^. 

If no name change is desired, only ofn^ is specified. 

The full descriptions of the following optional parameters (except CE and M=m) are given 
at the beginning of this section. 

Parameter Description 

PH=pasBword Specifies the new password. If PW=0 is specified, the CHANGE command 
clears the old password without setting a new password. 

CT=ct Specifies the new permit category for the file. Entries are P, PR, or 

PRIVATE for private; S or SPRTV for semiprivate; and PU or PUBLIC for 
public. 

M=m Specifies the new alternate user permission mode for semiprivate and 

public files. For direct access files, refer to the permission modes 
described in the DEFINE ccmmsuid description; for indirect access 
files, refer to the permission modes described in the SAVE c«nmand 
description. 
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BR*br 


Specifies the new backup copy selection; entries are Y (tape), MD 
(alternate storage ), and K (no backup). 


Specifies the preferred file residence; possible values are D (disk 
residence preferred), L (locked to disk), H (MSB or optical disk 
residence preferred), N (no preference), or T (tape alternate storage 
residence preferred) . If PR=pr is onitted, PR=N is assumed. 

SSssubsystem Specifies the new interactive sidssystem to Be associated with the 
file; entries are BASIC, BATCH, EXECUTE, FORTRAN, FTHTS, and NOLL. 

PNspackname Specifies the auxiliary device on which the file resides. This 
parameter csuinot specify a new file residence. 

R=r Specifies the device type on which the file resides. This parameter 

cannot specify a new file residence. 

NA Specifies the no abort option. If NA is specified, processing errors 

do not terminate the job. 

CE Clears file error code. It clears the recovery error field in the 

catalog entry. If the job is system origin, it also clears the 
alternate storage file errors. 

WB Specifies the wait-if-busy option. WB causes the job to wait for the 

mounting of disk packs. 

XD=expiredate Specifies the new expiration date for the file password. The value 
e3g>iredate must be a six-digit string of the form yymmdd; where yy, 
mm, and dd axe two-digit year, month, and day designators, 
respectively. 

XT=expireterm Specifies the new life of the file password in days. If you specify 
0, the file password expires immediately. If you specify 4095 or *, 
the file password does not e;g>ire. 

ACsac Specifies whether alternate users may obtain information about the 

file using CATLIST. Entries are Y (yes) and N (no) . The default 
value is N. 

CP Specifies that the charge cuid project numbers for the file are to be 

replaced by the charge and project numbers currently in effect for 
your job. 

COMMON COMMAND 

The COHHON command accesses the system file SYSTEM. 

Format: 

COMMON,SYSTEM. 

You must be authorized to access library files. If a file with the name SYSTEM is already 
local, no action is taken. Otherwise, the system searches for a library file with that 
name. If the system finds the file, it assigns the file to your job as a library type file. 


PR=pr 

I 
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DEFINE COMMAND 


The DEFINE CCTimand creates an empty direct access permanent file. It can also change a file 
of the local file type into a direct access file. In this case, the file must reside on a 
device on which you can place direct access files (refer to secondary masks and HSAI, CHRDECK 
entries in the NOS 2 Analysis H 2 mdboolc or contact site personnel) . When you create a file 
using the DEFINE command, the file is autcsnatically saved under the charge number and 
project number currently in effect for your job. 


Format: 

DEFINE, Ifn^spfnj^, Ifn 2 =pfn 2 , . . ., lfnjj=pfnjj/PW=password, CT=ct,M=m,BR=br, PR=pr, 
PNspackname, R=r, S=Bpace, NA, WB, AI,=level ,XD-e:q}iredate, XT=expireterm, AC=ac. 


Parameter Description 

lfn]^=pfn 3 ^ The DEFINE ccsnmand creates an empty direct access permanent file if 
pfnj^ and Ifnj^ do not exist. If Ifn^^s is omitted, pfn^^ is assumed to 
be the local file naune and the permanent file name. Each file name 
can be from one to seven characters. 

If the DEFINE command defines an existing local file as a direct 
access file, Ifn^ is the name of the local file, and pfnj^ is its new 
permcuient file name. 

The full descriptions of the following optional parameters (except M=m and S=space) au:e 
given at the beginning of this section. 


Parameter Description 

PW=password Specifies the 1- to 7-chairacter password that others must specify to 
access the file. 


CT=ct 


M=m 


Specifies the permit category of the defined file. Entries are P, PR, 
or PRIVATE for private; S or SPRIV for semiprivate; and P0 or PUBLIC 
for public. If CT=ct is not specified, CT=PRIVATB is assumed. 

Specifies the file access mode permitted to other users if the file is 
semiprivate or public, and if explicit access permission has not been 
granted to that user. If M^m is (xnitted, M-READ is assumed. 


If m is: 

E or EXECUTE 
R or READ 


Other users can attach the file in the following 
modes (refer to the ATTACH command description) : 

Execute. 

Read or execute. 
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Parameter 


Description 


I 


RD or READUPt 

Read update, read, or execute. 

RA or READApt 

Read append, read, or execute. 

RM or READMot 

Read modify, read append, read uqidate, read, or 
execute. 

O or UPDATE 

Update. 

A or APPEND 

Append. 

M or MODIFY 

Modify, append, update, read modify, read append, 
read update, read, or execute. 

W or WRITE 

Write, modify, append, update, read modify, read 
append, read update, read, or execute. 

N or NULL 

None. 


After a file is defined, it is always assigned to the job in write 
mode. 


BR=br Specifies the backup copy requirement; Possible values are MD (one 

backup copy required), N (no backup recpiired), or Y (two backup copies 
required) . If BR=br is omitted, BR=Y is assvuned. 

PR=pr Specifies the preferred file residence; possible values axe D (disk 

residence preferred), L (locked to disk), M (MSB or optical disk 
residence preferred), N (no preference), or T (tape alternate storage 
residence preferred). If FRspr is ooiitted, PR=N is assumed. 

PN=packname Specifies the name of an auxiliary device on which the direct access 
file is to reside. If PN=packnaine is omitted, the file residence is 
determined by the PR, R, and S parameters. 

R=r Specifies the device type on which the permanent file is to reside. 

Specify this psurameter if a removable auxiliary device with a device 
type other than the installation-defined default is used. The device 
must be a permanent file mass storage device on which direct access 
files are allowed. If Ifn^^ already exists on a device other than that 
specified or if an invalid device type is specified, a dayfile message 
so informs you. If an auxiliary device name is not specified by the 
PN=packname pareuneter or a previous PACKNAH ccxnmand, the file is 
defined on a family device. 

Ssspace Specifies the decimal number of PRDs requested for the file. It 

cannot be larger than your validation limit (refer to LIMITS Ccrnsnand 
in section 7) . If no device has the specified amount of space 
availsd)le, a dayfile message so informs you. 


t Special care should be taken when using modes KM, RA, or RU. Some prograuns do not 
anticipate that one user may be updating a file while other users are reading the same 
file. Specifically, CRH/AAM (refer to the CYBER Record Kaunager Advanced Access Methods 
Reference Manual) is not designed to handle concurrent reading and updating. If a program 
using CRM/AAM atteopts to access a file attached in RM, RA, or RU mode while a second 
program using CRM/AAM is accessing the file in M, A, or U mode, one or both programs may 
be aborted with an error message stating that the file was ruined. In fact, the file may 
still be intact, but CRH cannot guarantee this and does not allow the access. 
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Parameter 


Description 


This parameter ensures that the file is assigned to a device that has 
the requested space available at the time the file is defined. It 
does not guarantee that the space will be available when the file is 
written. 

NA Specifies the no abort option. If NA is specified, processing errors 

do not terminate the job. 

WB Specifies the wait-if-busy option. WB causes the job to wait for the 

mounting of disk packs. 

AL=level Specifies the security access level you want asssigned to the file. 

Unless changed by your site, level can be one of the following names: 

LVLO, LVLl, LVL2, LVL3, LVL4, LVL5, LVL6, or LVL7 
The default for this parameter is the current job access level. 

XD=expiredate Specifies the expiration date for the file password. The value 

expiredate must be a six-digit string of the form 3 ;ymmdd; where yy, 
mm, and dd are two-digit year, month, and day designators, 
respectively. You can specify this parameter only if you also specify 
PW=password. 

XT=expireterm Specifies the life of the file password in days. If you specify 0, 

the file password expires immediately. If you specify 4095 or *, the 
file password does not expire. You can specify this parameter only if 
you also specify PW=password. 

AC=ac Specifies whether alternate users may obtain information about the 

file using CATLIST. Entries are Y (yes) and N (no). The default is N. 

If Ifn^^ does not exist, the device on which pfnj^ resides depends on the R=r and S=space 
parameters. 

R=r S=space File Residence 

Specified Not specified The file resides on the device of type r with the most 

space available. 

Specified Specified The file resides on the device of type r with the most 

space available, provided that device has as many PRUs 
available as specified by the space parameter. 

Not specified Specified The file resides on the device with the most space 

available, provided that device has as many PRUs 
available as specified by the space parameter. 

Not specified Not specified The file resides on the device with the most space 

available. 

If an auxiliary device has been previously specified by a PACXNAM command, the file resides 
on that auxiliary device rather than a family device. 
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After the DEFINE command has been processed, the new direct access file remains attached to 
the job in write mode. After the file is returned, you must issue an ATTACH command to 
access the direct access file. If you purge an attached direct access file, the file 
remains attached to the job, although it has been removed from your permanent file catalog. 
Until you return the purged file, you cannot define a direct access file having the same 
local file name as the purged file. 


DROPDS COMMAND 

The DROPDS command releases the disk space associated with one or more of your permanent 
files, provided that a valid alternate storage copy (on cartridge (MSE) or tape alternate 
storage) exists for each file. The local file copies of these files (if they are present) 
are also returned by this command. 

Format: 

DROPDS,Ifn]^=pfn]^, lfn 2 =pf n 2 ,. •. ,lfnjj=pfnjj/PN=packname ,R=r ,NA,WB. 

Parameter Description 


lfni=pfni Specifies that the permanent file disk space associated with the file 
named pfni should be released. The local file named Ifni will be 
returned at the same time. 

If Ifni is omitted, the name of the local file is assumed to be pfni. 

The full descriptions of the following optional parameters are given at the beginning of 
this section. 

Parameter Description 

PN=packname Specifies the auxiliary device name. Specified if the permanent file 
to be released resides on an auxiliary device. 

E=r Specifies the device type. Specified if a removable auxiliary device 

on a device type other than the installation-defined default is to be 
used. 

NA Specifies the no abort option. If NA is specified, processing errors 

do not abort the job. 

WB Specifies the wait-if-busy option. The job waits for the mounting of 

removable auxiliary disk packs. 
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FTP COMMAND 


The File Transfer Protocol (FTP) is a DDN-defined protocol that provides file transfer 
capabilities between connected TCP/IP hosts. FTP allows you to access directories/files on 
a remote host and to perform common operations. Such operations include list and change 
working directories, list files at various levels, and rename directories and files. 

Format: 

FTP,I=input,0=output,P=ftpprlg. 


or 


CRECFC,I=input,O=output,P=f tpprlg. 


Parameter 


I=input 


O=output 


P=ftpprlg 


Description 


Specifies the local file which contains the directives that FTP sends 
to the remote host. The file name must be from 1— to 7—alphanumeric 
characters. The system reads directives from the current position on 
the file to the next EOR. If you omit the I=input parameter, the 
default is to use local file INPUT. 

Specifies the local file to receive the output generated by FTP. The 
file name must be from 1- to 7-alphanumeric characters. If you omit 
the O=output parameter, the default is to use local file OUTPUT. If 
you specify 0=0, then no output file is created. 

Specifies the prolog file. Values specified in the prolog file take 
precedence over those specified by FTP. The file name must be from 1- 
to 7-alphanumeric characters. Before being read, the file is rewound 
and cannot be assigned to a terminal. If the file is not local to the 
job, FTP attempts to acquire a permanent file of the same name. If 
the file is acquired, it is returned after prolog file processing is 
completed. If omitted, the default is to use file FTPPRLG. If you 
specify P=0, no prolog file is used. 


FTP DIRECTIVES 

The action taken by FTP depends on the directives you specify. Alternatively, you can 
specify a directives file with the I=lnput parameter. 

For more information on the FTP command, refer to the CDCNET TCP/IP Usage manual. 
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APPEND.FILE Directive 


The APPEND_FILiE directive appends data from a local host file to a corresponding remote host 
file. If the remote host file does not exist, then one is created by the remote host's 
server. 

^OTE I 

When you are specifying the embedded parameters 
(CS, FSC, and READEOI) found on the LOCAL_FILE 
parameter, and the destination host is a non-NOS 
system, it is necessary to explicitly specify the 
REM0TE_F1LE parameter. Allowing the embedded 
parameters to default without specifying the 
REMOTE_FILE parameter may result in a file name 
error. The following example appends file PROCL 
from NOS to file PROCL on NOS/VE: 

APPEND_FILE 'PROCL,CS=A,FSC=1,READEOI' PROCL 


Format: 

APPEND_FILE or 
APPF or 
APPEND or 
APPE 

LOCAL_FILE=local_name or 

LOCAL_FILE='local name,CS=cset,FSC=n,READEOI' 
REHOTE_FlLE=local_name 

Parameter Description 


LOCAL_FILE or Name of the local host file. 
LF 


CS 


Specifies the code set, data character size and format of the file on 
the NOS host. Files transmitted by FTP/NOS are mapped to network 
ASCII from the specified representation. This parameter is ignored 
unless the transfer type, as selected or defaulted by the 
CHANGE_TRANSFER_TYPE command, is ASCII (A). 

The following NOS FCOPY command compatible values are supported: 


Value 

ASCII or A 
ASCIIS or 8 

ASCII88 or 88 
DIS or D 


Description 


ASCII 6/12 file with zero-byte-terminated records. 

ASCII 8/12 file with TELNET end-of-line 
terminators. 

ASCII 8/8 file with TELNET end-of-line terminators. 

Display-coded file with zero-byte-terminated 
records. 


If this parameter is omitted, the default is ASCII (A). 
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Parameter 


Description 


FSC 


Specifies the number of files to be skipped before starting data 
transfer to the remote host. If this parameter is specified, n NOS 
end-of-file (EOF) marks are skipped before data transfer begins. Data 
transfer begins at file n+1 of a multifile set (BOI) of the file. 


If this parameter is omitted, the default is zero. Data transfer 
starts from the beginriing-of-information (BOI) of the file. 

READEOI Specifies read to end—of-information (EOI). If this parameter is 

specified, all files of a multifile set from the current file position 
to the EOI of the file are transferred with NOS EOF marks ignored. 

REMOTE_FILE Specifies the name of the remote file; same name as specified by the 
LOCAL_FILE or LF parameter. This parameter is required if specifying 
the embedded parameters CS, FSC, and READEOI, and the remote host is a 
non-NOS system. 


CHANGE_AUTO_LOGIN_MODE Directive 

The CHANGE_AUTO_LOGIN_MODE directive controls automatic login operations when a connection 
to a remote host has been established. 

Format: 

CHANGE_AUTO_LOGIN_MODE or 
CHAALM 

MODE=boolean 

Parameter Description 


MODE or Setting the MODE parameter to ON, TRUE, or YES enables auto login 

M mode. Setting the MODE parameter to OFF, FALSE, or NO disables auto 

login mode. The default is ON. 


CHANGE_BEU_MODE Directive 

The CHANGE_BELL_MODE directive controls the sending by FTP of an ASCII BEL character to 
interactive terminals with the input prompt. 

Format: 

CHANGE_BELL_MODE or 

CHABM or 

BELL 

MODE=boolean 

Parameter Description 


MODE or Setting the MODE parameter to ON, TRUE, or YES enables bell mode. 

M Setting the MODE parameter to OFF, FALSE, or NO disables bell mode. 

The default is OFF. 
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CHANGE_DEBUG_MODE Directive 

The CHANGE_DEBUG_MODE directive controls the display of debug mode output. 

Format: 

CHANGE_DEBUG_MODE or 

CHADM or 

DEBUG 

MODE=boolean 

Parameter Description 

Setting the MODE parameter to ON, TRUE, or YES enables debug mode. 
Setting the MODE parameter to OFF, FALSE, or NO disables debug mode. 
The default is OFF. 


CHANGE.FILE.NAME Directive 

The CHANGE_FILE_NAME directive renames a file on the remote host. 
Format: 

CHANGE_FILE_NAME or 

CHAFN or 

RENAME 

FILE=current file name 
NEW_FILE_NAME=new file name 

Parameter Description 

FILE or Name of a remote host file. 

F 

NEW_FILE_NAME Specifies a new name for the remote host file, 
or NFN 


MODE or 
M 


CHANGE.INPUT.FILE Directive 

The CHANGE_INPUT_FILE directive allows the specification of a new default input file. 
Format: 

CHANGE_INPUT_FILE or 
CHAIF 

INPUT=file 

Parameter Description 

INPUT or Specifies the input source file. The default is INPUT. 

I 
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CHANGE_OUTPUT_FIIJE Directive 

The CHANGE_OUTPUT_FILE directive allows the specification of a new output file> 
Format: 

CHANGE_OOTPUT_FILE or 
CHAOF 

OUTPUT=file 

Parameter Description 

OUTPUT or Specifies the new output file. The current file is flushed by 
0 writing an end-of-record (EOR) to it. The default is OUTPUT. 


CHANGE.PORT.COMMAND.MODE Directive 

The CHANGE_PORT_COMMAND_MODE directive specifies if the FTP PORT command should be sent to 
the remote host prior to a data transfer. 

Format: 

CHANGE_PORT_COMMAND_MODE or 
CHAPCM 

MODE=boolean 

Parameter Description 


MODE or Setting the MODE parameter to ON, TRUE, or YES enables port command 

M mode. Setting the MODE parameter to OFF, FALSE, or NO disables port 

command mode. The default is ON. 


CHANGE.TRANSFER.TYPE Directive 

The CHANGE_TRANSFER_TYPE directive defines to FTP the data of the file being transferred. 
When an FTP session is started, the default transfer type is ASCII. 

Format: 


CHANGEJTRANSFERJTYPE or 

CHATT or 

TYPE 


TYPE-keyword 

Parameter 

TYPE 


Description 

Specifies the data type of the file to be transferred. 

keyword Description 

ASCII or A ASCII 6/12 file with zero-byte-terminated records. 

BINARY or B or A mass storage file containing binary data, 

IMAGE or I represented in 8-bit bytes. 

The default is ASCII. 
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CHANGE_VERBOSE_MODE Directive 


The CHAKGE_VERBOSE_MODE directive controls the display status of FTP processing. For more 
information, refer to the FTP directive DISPliAY_IiOCAL_HELP. 

Format: 

CHANGE_VERBOSE_MODE or 

CHAVM or 

VERBOSE 

MODE=boolean 

Parameter Description 

MODE or Setting the MODE parameter to ON, TRUE, or YES enables VERBOSE_MODE. 

M Setting the MODE parameter to OFF, FALSE, or NO disables 

VERBOSE MODE. The default is OFF. 


CREATE_HOST_CONNECTION Directive 

The CREATE_HOST_CONNECTION directive establishes a connection with a remote host. An 
existing host connection must be deleted with the DELETE_H0ST_C0NNECT10N directive before a 
new connection to another host can be made. 

Format; 

CHANGE_HOST_CONNECTION or 

CREHC or 

OPEN 

HOST=name 

AUTO_LOGIN_MODE=boolean 

Parameter Description 

HOST or The name of the remote host where a connection is to be established. 

H 

AUT0_L0GIN_ Specifies whether an automatic login attempt should be made when a 
MODE or connection to a host has been established. 

ALM 

Setting AUTO_LOGIN_MODE to ON, TRUE, or YES enables AUTO_LOGIN_MODE. 
Setting AUTO_LOGIN_MODE to OFF, FALSE, or NO disables AUTO_LOGIN_MODE. 

If automatic login is enabled and no login information for the 
specified host has been made available by the DEFINE_AUTO_LOGIN 
directive, then a prompt is Issued for user name, password, and if 
required, account. Automatic login information is established with 
the DEFINE_AUTO_LOGIN directive. For more information, refer to the 
DEFINE_AUTO_LOGIN directive. 

If this parameter is omitted, the default is ON. 
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DEFINE.AUTO.LOGIN Directive 


The DEFINE_AUT0_L0G1N directive associates login information with a host name, so when a 
connection to that host is established, the user can be automatically logged in. 

Format: 

DEFINE_AUTO_LOGIN or 
DEFAL 

HOST=name 

USER=username 

PAS SWORD=pas swo rd 
FAMILY=family 
ACCOirNT=account 
PROJECT=project 

Parameter Description 

HOST or Name of the remote host associated with the login information. 

H 

USER or The login user name. 

U 

PASSWORD or Password associated with the login user name. 

PW 

FAMILY or Family name associated with the login user name if different from 

F the default family name used on the remote host. 

ACCOUNT or Account assoicated with the login. This parameter specifies the 

A nondefault account to which the resource usage on the remote host is 

charged. 

PROJECT or Project associated with the login. This parameter specifies the 

P nondefault project to which the resource usage on the remote is 

charged. If this parameter is omitted, the default established by the 
server's host administrator is used. 


DELETE.FILE Directive 

The DELETE_FILE directive deletes a file on the remote host. 
Format: 

DELETE_FILE or 
DELF or 
DELETE or 
DELE 

NAME=name 

Parameter Description 

NAME or Name of the remote host file to be deleted. 

N 
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DELETE_HOST_CONNECTION Directive 


The DELETE_HOST_CONNECTION directive terminates an existing connection with a remote host 
without terminating FTP. 

Format: 

DELETE_HOST_CONNECTION or 

DELHC or 

CLOSE 


DISPLAY_COMMAND_INFORMATION Directive 

The DISPLAY_COMMAIID_INFORMA.TION directive displays information regarding a specific FTP 
directive. 

Format: 

DISPLAY_COMMAND_INFORMATION or 
DISCI 

COMMAND=FTP command 

Parameter Description 


COMMAND Name of an FTP directive for which information is required. 


DISPLAY.DIRECTORY Directive 

The DISPLAY_DIRECTORY directive displays a detailed list of files in the specified remote 
directories. The default is to display the current directory. If the name specified is a 
file name on the remote server host, current information on the file is displayed. To 
display the local directory, use the NOS/VE command DISPLAY_CATALOG or the NOS command 
CATLIST. 


Format: 


DISPLAY_DIRECTORY or 
DISD or 
DIR or LIST 
NAME=name 
OUTPUT=local name 


Parameter Description 


NAME or Remote host file name. 

N 


OUTPUT or Allows the specification of an output file other than the default. 
0 The default is OUTPUT. 
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DISPLAY_FILE_NAMES Directive 

The DISPLAY_FILE_NAMES directive displays a list of file names in a remote directory 
Format; 


DISPLAY_FILE_NAMES or 
DISFN or 
LS or 
NLST 

NAME=name 
OUTPOT=local name 


Parameter 


NAME or 
N 

OUTPUT or 
0 


Description 


Remote host file name. 


Allows the specification of an output file other than the default. 
The default is OUTPUT. 


DISPLAY_FTP_OPTIONS Directive 

The DISPLAY_FTP_OPTIONS directive allows the user to obtain current information about the 
existing FTP connection. 

Format: 

DISPLAY FTPJOPTION or 
DISFO 


DISPLAY_LOCAL_HELP Directive 

The DISPLAY_LOCAL_HELP directive provides information about each command. The output 
contains the FTP command, a brief description of the command, and the aliases of the command. 

Format: 

DISPLAY_LOCAL_HELP or 

DISLH or 

HELP 

FTP/NOS directly supports the DISPLAY_COMMAND_INFORMATION directive to display parameter 
information for a specific directive. 
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DISPUY_REMOTE_HELP Directive 

The DISPLAY_REMOTE_HELP directive provides help information from the remote FTP server. 
Format: 

DISPLAY_REMOTE_HELP or 

DISRH or 

REMOTEHELP 

COMMAND=f tp_command 

Parameter Description 

COMMAND or Identifies a specific FTP command for which a user wants help. 

C 


GET.FILE Directive 

The GET FILE directive retrieves a file from the remote host. 


NOTE 


When specifying the embedded parameters (CS 
and TRUNC) found on the LOCAL_FILE 
parameter, and the destination host is a 
non-NOS system, it is necessary to 
explicitly specify the REMOTE_FILE 
parameter. Allowing the embedded parameters 
to default without specifying the 
REM0TE_F1LE parameter may result in a file 
name error. 

The following example gets a file named 
PROCL on NOS/VE and makes it a local file on 
NOS. 


GET_FILE PROCL 'PROCL,CS=A,' 
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QUIT Directive 


The QUIT directive terminates execution of FTP. 

Format: 

QUIT or 
QUI or 
BYE or Q 

ABORT=boolean 

Parameter Description 

ABORT Specifies whether to abort the current connection before terminating 

the execution of FTP. 

Setting the ABORT parameter to ON, TRUE, or YES causes FTP to abort 
the current connection before terminating; setting the ABORT parameter 
to OFF, FALSE, or NO causes FTP to close any existing connection 
before terminating. 

If this parameter is omitted, by default FTP tries to close any 
existing connection before terminating. 
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REPLACE.FILE Directive 


The REPLACE_FILE directive sends data from a file on the local host to a file on the remote 
host. If the file does not exist on the remote host, it is created. 


I KOTE 


When specifying the embedded parameters (CS, ESC, 
and READEOI) found on the LOCAL_FILE parameter, and 
the destination host is a non-NOS system, it is 
necessary to explicitly specify the REMOTE_FILE 
parameter. Allowing the embedded parameters to 
default without specifying the EEM0TE_F1LE 
parameter may result in a file name error. 

The following example replaces file PROCL on NOS/VE 
with file PROCL on NOS. 

REPLACE_FILE 'PROCL,CS=A,FSC=1,READEOI' PROCL 


Format: 

REPLACE_FILE or 

REPF or 

PUT or 

SEND or 

STOR 

LOCAL_FILE=local name or 

LOCAL FILE='locaT name, CS=cset, FSC=n, READEOI' 
REMOTE_F ILE=name 

Parameter Description 


LOCAL_FILE or Name of a local host file. 

LF 

CS Specifies the code set, data character size, and format of the file on 

the NOS host. Files transmitted by FTP/NOS are mapped to network 
ASCII from the specified representation. This parameter is ignored 
unless the transfer type, as selected or defaulted by the 
CHANGEJTRANSFERJTYPE command, is ASCII (A). 

The following NOS FCOPY command compatible values are supported: 

Value Description 

ASCII or A ASCII 6/12 file with zero-byte-terminated records. 

ASCIIS or 8 ASCII 8/12 file with TELNET end-of-line 

terminators. 
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Parameter 


Description 


Value Description 

ASC1I88 or 88 ASCII 8/8 file with TELNET end-of—line terminators. 

DIS or D Display-coded file with zero-byte-terminated 

records. 

If this parameter is omitted, the default is ASCII (A). 

FSC Specifies the number of files to be skipped before starting data 

transfer to the remote host. If this parameter is specified, n NOS 
end-of-file (EOF) marks are skipped before data transfer begins. Data 
transfer begins at file n+1 of a multifile set (BOI) of the file. 

READEOI Specifies read to end-of-information (EOI). If this parameter is 

specified, all files of a multifile set from the current file position 
to the EOI of the file are transferred with NOS EOF marks ignored. 

REM0TE_F1LE Specifies the name of the remote file; same name as specified by the 
L0CAL_FILE or LF parameter. This parameter is required if specifying 
the embedded parameters CS, FSC, and READEOI, and the remote host is a 
non-NOS system. 


SEND.FTP.COMMAND Directive 

The SEND_FTP_COMMAND directive allows the sophisticated FTP user to directly send an FTP 
command to a remote host. It receives a single reply from the remote server. This command 
is used for debugging purposes by users who are familiar with the FTP protocol. This 
command does not work for FTP commands that initiate a data transfer (LIST, NLST, STOR, 
RETR, and APPE). 

Format: 

SEND_FIP_COMMAND or 

SENFC or 

QUOTE 

COMMAND=f tp_command 

PARAMETERS=command_parame ter s 

Parameter Description 

COMMAND Sends 3- or 4-character FTP commands. 

PARAMETERS Sends additional parameters required for the given FTP command. 
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GET CX>MMAND 

The GET command retrieves copies of indirect access permanent files for use as local files. 

Format: 

GET,lfn]^=pfni ,lfn 2 =pfn 2 ,... ,lfnjj=pfnji/UN=username,PW=password,PN=packname, 

R=r,NA,RT,WB. 

Parameter Description 

lfnjr=pfn£ Specifies the local file name Ifn^ given the retrieved copy of 
indirect access permanent file pfn^. If lfn£= is omitted, the 
local copy of the permanent file is called pfn^. If no files are 
named, the system uses the primary file name for the permanent file. 

If local file Ifn exists when this command is processed, the file is 
returned (even if command processing does not complete due to an 
error). 

The full descriptions of the following optional parameters are given at the beginning of 

this section. 

Parameter Description 

UN=username Specifies the user name. Specified if the permanent file(s) is in 
another user's catalog. You must have permission to read or execute 
the file(s) (refer to SAVE Command in this section). If only execute 
permission has been granted, the file is retrieved in execute-only mode. 

PW»password Specifies the file password. Specified if UN=username is specified, 
and if the permanent file has a password. 

PN=packname Specifies the auxiliary device name. Specified if the permanent 
flle(s) resides on an auxiliary device. 

R=r Specifies the device type. Specified if PN=packname is specified, or 

if a PACKNAM command has been processed and the device type is other 
than the system default. 

NA Specifies the no abort option. If NA is specified, processing errors 

do not terminate the job. 

RT Specifies the real-time processing option. If RT is specified, the 

job continues processing after requesting staging of a file from 
alternate storage to disk. If staging is not required (the file is 
already resident on disk), the file is assigned to the job. If the 
file must be staged, you must issue a second GET command to assign the 
file to the job. 

If RT is omitted and the file resides only on alternate storage, job 
processing is suspended while the file is staged to disk and assigned 
to the job. For more information on alternate storage, refer to 
Alternate Storage in section 2. 

WB Specifies the wait-if-busy option. WB causes the job to wait for the 

mounting of disk packs. 
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Each permanent file named must be an indirect access file. If the file, Ifn^, is assigned 
to the job before this command is processed, it is returned. The new local file is rewound 
after it is retrieved. More than one user can have local copies of an indirect access file 
assigned to their jobs simultaneously. 

If your current primary file is specified as an Ifn on the command, a copy of the associated 
permanent file, pfn, becomes the primary file. The subsystem associated with the permanent 
file, pfn, becomes the job's current subsystem (refer to section 8). 

If an auxiliary device has been previously specified by a PACKNAM command, the system 
attempts to find pfn^ on the auxiliary device rather than on the family device. 


MFLINK COMMAND 

The MFLINK command optionally transfers a file to or from another mainframe or creates, 
purges, or otherwise changes the attributes of a permanent file on another mainframe. You 
must be authorized to use the MFLINK command (refer to the LIMITS command). 

Format: 

MFLINK,Ifn,ST=lid,I=dirfile,DD=dd,EP,RT,PC=c. 

Parameter Ifn is order—dependent, it must be the first parameter. If you omit Ifn, you must 
have two consecutive delimiters after MFLINK. The other parameters are order—independent. 

Parameter Description 


Ifn Specifies the optional local file name to be used in any file trans¬ 

fers. The file name must be one to seven alphanumeric characters and 
Ifn must reside on disk. If the transfer is from the local host to 
the remote host, Ifn must be a local file before you enter the MFLINK 
command. If the transfer is from the remote host to the local host, 
MFLINK either writes over the existing Ifn, or if there is no local 
file, MFLINK creates a new file with the name Ifn. If you omit Ifn, 
but subsequent directives call for a file transfer, MFLINK uses LFILE 
as the default Ifn. Some directives, such as CHANGE, PERMIT, and 
PURGE (for a NOS remote host) do not require an Ifn, because they do 
not cause a file transfer. MFLINK rewinds Ifn before and after the 
transfer. 

ST=lid Specifies the logical identifier (LID) of the remote host to which 

MFLINK is to send the directives record. The LID must be a 
three-character string defined by your site. You must specify the ST 
parameter on the first, and only the first, MFLINK command of a series 
of MFLINK commands (an MFLINK session) that are for the same remote 
host. The ST=lid specification remains in effect during the entire 
session. On subsequent MFLINK commands in the same session, any other 
parameters not specified revert to their default values. The 
occurrence of the ST=lid parameter on an MFLINK command initiates a 
new MFLINK session with the specified remote host. Once you have 
entered an MFLINK command with an ST*lid parameter, you can resume 
that MFLINK session at any time during your job by entering an MFLINK 
command without an ST=lid parameter. 
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Parameter 


Description 


I=ditfile 


DD=dd 


Specifies the local file which contains the directives that the system 
sends to the remote host. The file name must be one to seven 
alphanumeric characters. The system reads directives from the current 
position on the file to the next EOR. If you specify only the keyword 
I, file INPUT becomes the directives file. If you omit the I=dirfile 
parameter, the system reads directives from the lines immediately 
following the MFLINK command. In this case, the directives must all 
begin with a prefix character and the system reads directives until it 
comes to a line without the prefix character. 

Specifies the data format of the file to be transferred. The DD=dd 
parameter both describes the character set of Ifn on the host where it 
currently resides and also specifies the character set Ifn is to have 
after the transfer. 

For file transfers between NOS mainframes and between NOS/BE and NOS 
mainframes this parameter is effectively ignored. The file will have 
the same format on both mainframes. 

The interpretation of the DD=dd parameter depends on the operating 
system(s) involved in the file transfer. The following paragraphs 
describe how NOS interprets the DD=dd parameter. For its 
interpretation by other operating systems, refer to the Remote Host 
Facility Usage manual. 

On NOS, you can specify the following values for dd: 
dd Description 


C6 The file contains character data in a 64-character (or less) 
subset of the ASCII 128-character set. The character code 
of Ifn is 6-bit display code and its lines are zero-byte 
terminated. 

C8 The file contains character data in a larger than 

64-character subset of the ASCII 128-character set. The 
character code of Ifn is the 7-bit ASCII code (right- 
justified in 12-bit fields) and its lines are zero-byte 
terminated. 

US Specifies that the file contains binary data in structured 
format with EORs and EOFs. The file is transmitted as a 
continuous string of binary data, broken only by EORs and 
EOFs as appropriate. 

UU Specifies that the file contains binary data without EORs 
and EOFs. NOS treats UU as US. If you send a file to a 
non-NOS or non-NOS/BE remote host with DD=UU specified and 
the file contains EORs or EOFs, the remote host may ignore 
them. 
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Parameter 


Description 


If the file is character data, you do not need to specify a DD=dd 
parameter. The remote host determines the format in which to 
read/write the file. If you transfer a binary file to or from a 
mainframe with a different word size than the model 170, the mainframe 
may add extra bits at EOEls or EOFs. 


EP Specifies the error processing that ensues if network problems cause a 

loss of the connection during a file transfer. If you omit the 
parameter EP, the system retries the request. The EP parameter 
inhibits this retry. The system attempts to correct data transmission 
errors, regardless of the EP parameter. 

ET Specifies the real-time action the system is to take when network 

resources are temporarily unavailable. If you specify RT and some 
network resource necessary for you to connect to a remote host is 
unavailable, MFLINK aborts without any retries. If you do not specify 
RT, after an installation-defined period of time MFLINK retries until 
the connection is successful. 


PC=c Specifies the prefix character for MFLINK directives. The default 

prefix character is an asterisk (*). The prefix character can be any 
6-bit display code character except a closing parenthesis, a dollar 
sign, a period, comma, or a colon. To avoid confusion between 
commands and routing directives, use caution in selecting alphabetic 
characters for the prefix character. 


MFLINK DIRECTIVES 

The action taken by MFLINK depends on the directives you specify. You can specify directives 
immediately following the MFLINK command if you prefix each directive with the prefix char¬ 
acter. The system discards the prefix characters before forwarding the directives to the 
remote host. Alternatively, you can specify a directives file with the I=dirfile parameter. 
The directives in the directives file do not require the prefix character. The directives 
must be commands recognized by the remote host; for example, if the remote host is a NOS/BE 
system, your directives must be NOS/BE commands. NOS allows only a small subset of its 
commands to be used as MFLINK directives and, further, may require some directives to have a 
slightly different form or function from their command counterparts. 

This section documents only those MFLINK directives valid for a NOS remote host. For other 
remote hosts, refer to the Remote Host Facility Usage manual. 

NOS, as a remote host, processes directives of up to 80 characters. A directive longer than 
80 characters terminates the processing of the current directives record. A directive can 
span more than one line as long as it does not exceed the 80-character limit. You Indicate 
that the next line is a continuation line by ending the current line with a comma. 
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The MFLIKK directives fall into the three categories of recovery directives, file transfer 
directives, and file alteration directives as follows: 


Recovery 


File Transfer 


File Alteration 


USER 

CHARGE 


APPEND 

ATTACH 

DEFINE 

GET 

REPLACE 

SAVE 


CHANGE 

PERMIT 

PURGE 

PACKNAM 


Recovery directives are directives that a host must send a remote host any time you initiate 
or resume an MFLINK session. File transfer directives are directives that transfer a file 
from one host to another. There can be only one file transfer directive in a given direc¬ 
tives record. 

The directives operate in a manner similar to that of their NOS command counterparts. One 
exception is the function of the NA keyword. 

The NA option on an MFLINK directive works in a manner very similar to the NA option on NOS 
permanent file commands. The main difference is that the system does not suspend MFLINK 
processing indefinitely while it waits for a temporary error condition to clear. If APLO 
(removable pack option) is set to NONZERO (refer to the description of COMSPFM parameters in 
the Installation Handbook) and the temporary error condition persists beyond an 
installation-defined timeout period, MFLINK Issues a message indicating that the timeout 
occurred and then continues. If APLO is set to ZERO, MFLINK will not wait for a pack to be 
mounted but will continue immediately. 

The following directive descriptions show the format of each directive and describe the func¬ 
tion of each directive whose function differs from that of its NOS command counterpart. 

APPEND Directive 

The APPEND directive adds the file specified on the MFLINK command (Ifn) to the end of pfn. 
Format: 


APPEND,pfn/UN=username,PW=password,PN=packname,R=r,NA,WB. 

ATTACH Directive 

The ATTACH directive retrieves a copy of pfn from the remote host and makes that copy a 
temporary file with the name specified on the MFLINK command. No interlock is maintained 
between Ifn and pfn, except during the file transfer (as if M=READ had been specified). 

Format: 


ATTACH,pfn/UN“username,PW=password,PN=packname,R’=r,NA,RT,WB. 

CHANGE Directive 

The CHANGE directive operates the same as the NOS command. 

Format: 


CHANGE,nfn=ofn/PW=password,CT=ct,M=m,BR=br,PR=pr,PN=packname, 
R=r,NA,CE,WB,XD=expiredate,XT=expireterm,AC=ac,CP. 
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CHARGE Directive 

The CHARGE directive operates the same as its NOS command counterpart, including the 
handling of default charges. 

Format: 

CHARGE,chargenumber,proje ctnumber. 

If the CHARGE directive is required, it must immediately follow the USER directive. 


DEFINE Directive 

The DEFINE directive creates a direct access file named pfn on the remote host and copies 
onto it the file specified by Ifn on the MFLINK command. There is no provision to copy over 
an existing direct access file; you must purge the existing file. No interlock is 
maintained between Ifn and pfn, except during the file transfer (as if M=READ had been 
specified). 

Format: 


DEFINE,pfn/PW=password,CT=c,M=m,BR=br,PR=pr,PN=packname,R=r,S=space,NA,WB, 
AL=level,XD=expiredate,XT=expireterm,AC=ac. 


DROPDS Directive 


The DROPDS directive releases the current copy of a permanent file from mass storage when a 
backup copy has been saved on a storage device. 

Format: 


DROPDS,pfn/PN“packname,R=r,NA,WB. 


GET Directive 

The GET directive retrieves a copy of a permanent file from the remote host and gives it the 
name Ifn, specified on the MFLINK command. 

Format: 


GET,pfn/UN=username,PW=pas sword,PN=packname,R=r,NA,RT,WB. 

PACKNAM Directive 

The PACKNAM directive operates the same as its NOS command counterpart. If you use the 
PACKNAM directive, it must precede any file transfer directive in the same directives 
record. The PACKNAM directive only applies to the directive record in which it appears. 

Format: 


PACKNAM,PN=packname,R=r. 
or 

PACKNAM,packname,R=r. 
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If you are authorized to access auxiliary devices, you can always access files on an 
auxiliary device that is already mounted. If you attempt an MFLINK access of a file on an 
unmounted auxiliary device, you get a DEVICE UNAVAILABLE message unless your site has 
enabled the wait-for-unmounted-device installation option. If this option is present on 
more than one mainframe in an RHF network, a deadlock situation is possible. If such a 
deadlock occurs, MFLINK would time-out the connection as discussed previously. 


PERMIT Directive 

The PEEMIT directive operates the same as its NOS command counterpart. 

Format: 

PERMIT,pfn,username=m/PN=packname,R=r,NA,WB,XD=expiredate,XT=expireterm. 

PURGE Directive 

The PURGE directive operates the same as its NOS command counterpart. 

Format: 

PURGE,pfn/UN=username,PW=pas sword,PN=packname,R=r,NA,WB. 


REPLACE Directive 

The REPLACE directive replaces pfn on the remote host with file Ifn, as specified on the 
MFLINK command. 

Format: 


REPLACE,pfn/UN=username,PW=password,PN=packname,R=r,NA,WB. 


SAVE Directive 

The SAVE directive creates an indirect access file named pfn on the remote host and copies 
onto it the file specified by Ifn on the MFLINK command. 

Format: 


SAVE,pfn/PW=password,CT=ct,M=m,BR=br,PR=pr,PN=packname,R=r,NA,WB,AL=level, 
XD=expiredate,XT=expireterm,AC=ac. 


USER Directive 

The USER directive specifies validation information for the remote host. It operates the 
same as its NOS command counterpart. The USER directive must be the first directive 
associated with an MFLINK command that has ST=lid specified. You do not need to specify 
this directive at any other time. 

Format: 


USER,username,password,familyname. 

If the remote host is a NOS Version 2.2 or higher system, the password specified must be the 
batch password. 
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INTERACTIVE USE OF MFLINK 


When you use MFLINK in an interactive job, the system obtains the directives in one of the 
following ways: 

• If you specify I=dirfile on the MFLINK command, the system reads the local file 
named dirfile. If dirfile is assigned to the terminal, the system prompts the 
terminal using the prefix character. 

• If you omit the I=dirfile parameter, the system also prompts the terminal using the 
prefix character. If the MFLINK command is part of a procedure, the system reads 
the lines immediately following the command. If the first line following the 
command does not begin with the prefix character, the system prompts the terminal. 

When reading from the terminal, the system prompts for directives until you enter an empty 
line (only a carriage return) or the prefix character in response to a prompt. The system 
then sends the directives (minus the prefix character) to the remote host. The remote host 
responds with messages Indicating the success or failure of the operations. 

Any time you enter an MFLINK command that has the ST=lid specified, the system initiates a 
new MFLINK session. If you enter the command without the ST=lid parameter, the system 
resumes the session with the remote host currently connected. 

Examples: (NOS to NOS) 

1. Assume you are at mainframe MFB. To transfer a file from mainframe MFA to MFB and 
purge it on MFA, you must enter commands and directives similar to the following: 

MFLINK, NEWFILE, ST =MFA. 

*USER,XYX,ABC. 

*ATTACH,OLDFILE/PN=USER. 

*PURGE,OLDFILE/F>N=USER. 

2. Assume you are on mainframe MFB. To transfer four files from mainframe MFA, enter 
commands and directives similar to the following: 

MFLINK,FILE 1,ST=« FA,I=0IRECTS. 

MFLINK,FILE2,I=DIRECTS, 

MFLINK,FILE3,I=OIRECTS. 

MFLINK,FILE4,I=DIRECTS. 

The file DIRECTS has the following contents: 

USER,XYZ,ABC. 

CHAR6E,1234,345N355. 

GET,LFN1. 

-EOR- 

GET,LFN2. 

-EOR- 

ATTACH,PFN1/PN=USER. 

-EOR- 

ATTACH,PFNS. 

-EOI- 
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OLD COMMAND 


The OLD command retrieves a copy of an indirect access permanent file and makes it the 
primary file. 

Format: 

OLD,Ifn=pfn/UN=us e rname,PW=pas sword,PN=packname,R=r,NA,ND,WB,RT. 

Parameter Description 

Specifies the one- to seven-character file name Ifn given to the 
primary file copy of indirect access permanent file pfn. If lfn= is 
omitted, the primary file is named pfn. If local file Ifn exists when 
this command is processed, the file is returned (even if command 
processing does not complete due to an error). 

The full descriptions of the following optional parameters (except ND) are given at the 
beginning of this section. 

Parameter Description 

UN=username Specifies the user name. Specified if the indirect access permanent 
file is in another user's catalog. 

PW=password Specifies the file password. Specified if UN=username is specified, 
and if the permanent file has a password. 

PN=packname Specifies the auxiliary device name. Specified if the permanent file 
resides on an auxiliary device, 

R=r Specifies the device type. Specified if an auxiliary device of a 

device type other than the installation-defined default is to be used. 

NA Specifies the no abort option. If NA is specified, processing errors 

do not terminate the job, 

ND Specifies the no drop option. If ND is specified, OLD changes the 

former primary file into a local file, but does not return any files. 
If ND is omitted, OLD returns all files that do not have checkpoint or 
no-auto-drop status. 

WB Specifies the wait-if-busy option. WB causes the job to wait for the 

mounting of disk packs. 

RT Specifies the real-time processing option. If RT is specified, the 

job continues processing after requesting staging of a file from 
alternate storage to disk. If staging is not required (the file is 
already resident on disk), the file is assigned to the job. If the 
file must be staged, you must issue a second OLD command to assign the 
file to the job. 

If RT is omitted and the file resides only on alternate storage, job 
processing is suspended while the file is staged to disk and assigned 
to the job. For more information on alternate storage, refer to 
Alternate Storage in section 2. 


lfn=pfn 

I 
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If an auxiliary device has been previously specified by a PACKNAM command, the system 
attempts to find the permanent file, pfn, on the auxiliary device rather than on the family 
device. 

If you do not specify the ND parameter, the system releases all files assigned to the job, 
except those with checkpoint or no-auto-drop status. Certain system files (for example, 
ZZZZZCO, ZZZZZCl, ZZZZZC2, and ZZZZZLD) always have no—auto-drop status. You can give any 
local file this status by using the SETFS command. A copy of the indirect access permanent 
file named on the OLD command becomes the primary file. Ihe primary file is positioned at 
its BOI. 

The primary file is rewound before every job step. Therefore, the file positioning commands 
have no effect on the primary file. Also, when two commands are issued to write on the 
primary file, the second writes over the data written by the first because the primary file 
is rewound between commands. 


PACKNAM COMMAND 

The PACKNAM command directs subsequent permanent file requests to the specified auxiliary 
device. 

Format: 


PACKNAM,PN=packname,R=r. 
or 

PACKNAM,packname,R=r. 
or 

PACKNAM. 

Parameter Description 


PN=packname Specifies the one- to seven-character identifier of the 

auxiliary device to be accessed in subsequent permanent file 
commands. 

R=r Specifies the device type of the auxiliary device specified 

by packnam. 

You specify this parameter if you want to use a removable 
auxiliary device whose device type differs from the 
installation-defined defaxilt. 

If you do not specify this parameter for a nondefault type 
pack, you must specify this parameter on each subsequent 
permanent file command. 

A full description of this parameter appears at the beginning 
of this section. 
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PACKNAM allows you to omit the PN=packname parameter on command requests for files that 
reside on the specified auxiliary device. However, to request permanent files on another 
auxiliary device, you must specify the PN=packname parameter on the file request or enter 
another PACKNAM command before the request (you must also specify the R=r parameter if the 
device type is different). Refer to Mass Storage File Residence in section 2 for 
information concerning auxiliary permanent file devices. 

You can access permanent files residing on the family system devices while the PACKNAM 
request is in effect by specifying PN=0 on permanent file commands. To clear the effect of 
a PACKNAM command, include a PACKNAM command in either of the following formats. 

PACKNAM. 

or 

PACKNAM,PN=0. 


PERMIT COMMAND 

The PERMIT command explicitly permits another user to access a private file in your 
permanent file catalog. The PERMIT command can also change the mode in which another user 
can access a semiprivate or public file. 

Format; 

PERMIT,pfn,username^=mj^ ,username 2 =m 2 ,. . . ,usernamejj=mjj/PN=packname,R=r,NA,WB, 
XD=expiredate,XT=expireterm. 

Parameter Description 

pfn Name of the file for which access permission is granted. 

usernamejL=mj^ Specifies that user name username^^ is granted the access 

permissions indicated by access mode If m^ is omitted, 

the read access mode is assumed. If m^^ is NULL, the user is 
explicitly denied permission to access the file. For the 
available access modes, refer to the DEFINE Command or SAVE 
Command description in this section. 

The full descriptions of the following optional parameters are given at the beginning of 
this section. 

Parameter Description 

PN=packname Auxiliary device name. Specified if the permanent file resides on an 
auxiliary device. 

R=r Device type. Specified if a removable auxiliary device on a device 

type other than the installation-defined default is to be used. 
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Parameter 


Description 


NA No abort option. If NA is specified, processing errors do not 

terminate the job. 

WB Specifies the wait-if-busy option. WB causes the job to wait for the 

mounting of disk packs. 

XD=expiredate Specifies the expiration date for the file permit. The value 

expiredate must be a 6-digit string of the form yymmdd; where yy, mm, 
and dd are 2-digit year, month, and day designators, respectively. 

XT=expireterm Specifies the life of the file permit in days. If you specify 0, the 
file permit expires immediately. If you specify 4095 or *, the file 
permit does not expire. 


PURGALL COMMAND 

The PURGALL command purges all permanent files in your catalog that satisfy the criteria 
specified by the parameters. 

Format: 

PURGALL,AD=ad,AF,CD=cd,CT=ct,DF,DN=dn,EF=ef,FN=fn,MD=md,NA,PN=packname,R=r,TM=tm,Ty=ty,WB. 
Parameter Description 


AD=ad Specifies the last access date; its format is yymmdd. All files last 

accessed before this date are purged, unless the AF parameter is 
specified. 

AF Specifies that files accessed after the date specified by the AD=ad 

parameter, modified after the date specified by the MD=md parameter, 
or created after the date specified by the CD=cd parameter are purged. 

CD=cd Specifies the creation date; its format is yymmdd. All files created 

before this date are purged, unless the AF parameter is specified. 

CT=ct Specifies the file category to be purged. Entries are P, PR, or 

PRIVATE for private; S or SPRIV for semiprivate; and PU or PUBLIC for 
public. 

DF Specifies that a dayfile message will be issued for each file that is 

purged. 

DN=dn Specifies the device number assigned to a device during system 

initialization. Only files on that device are purged. 
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Parameter 


EF=ef 


FN=fn 


MD=md 


Description 


Specifies one or more excluded permanent file names. This parameter 
excludes these permanent files from being purged. 

An asterisk (*) present In a file name Indicates that a set of files 
Is to be excluded. For example, EF=***OPL will exclude from purging 
all the files with 6-character names that end In OPL; eF=M****** will 
exclude from purging all the files with names that start with the 
letter M. 

Multiple file names may be specified, separated by slashes. For 
example, eF=A******/B******/C****** will exclude from purging all the 
files with names that begin with the letters A, B, or C. 

The EF parameter may be specified together with the FN parameter. For 
example, FN=AB*****,EF=ABC**** will purge all the files with names 
that start with the letters AB, except for those files with names that 
start with the letters ABC. 

Specifies one or more permanent file names. This parameter restricts 
the purge to these permanent file names. 

An asterisk (*) present In a file name Indicates that a set of files 
Is to be purged. For example, FN=***OPL will purge all the files with 
6-character names that end In OPL; fN=M****** will purge all the files 
with names that start with the letter M. 

Multiple file names may be specified, separated by slashes. For 
example, fN=A******/B******/C****** will purge all the files with 
names that begin with the letters A, B, or C. 

The FN parameter may be specified together with the EF parameter. For 
example, FN=AB*****,EF=ABC**** will purge all the files with names 
that start with the letters AB, except for those files with names that 
start with the letters ABC. 

Specifies the last modification date; Its format Is yymmdd. All files 
last modified before this date are purged, unless the AF parameter Is 
specified. 
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Parameter 


Description 


NA Specifies the no abort option. If the specified auxiliary device is 

not available, the job is suspended until it becomes available. 

PN=packname Specifies the name of the auxiliary device on which the files to be 
purged reside. The PN parameter cannot be specified if a device 
number is specified (DN=dn). 

Specifies the type of auxiliary device on which the files to be purged 
reside. The R parameter cannot be specified if a device number is 
specified (DN=dn). 

TM=tm Specifies the time of day on the date specified by the AD, MD, or CD 

parameter; its format is hhmmss. 

TY=ty Specifies the file type to be purged. 

ty Action 

A or ALL Purges all files. 

D or DIRECT Purges all direct access files. 

I or INDIR Purges all indirect access files. 

If this parameter is omitted, but other parameters are specified, the 
system assumes ty is ALL. To purge all files if no other parameters 
are specified, you must specify TY=A. 

WB Specifies the wait-if-busy option. WB causes the job to wait for the 

mounting of disk packs. 

To purge all files in your catalog, you must enter; 

PURGALL,TY=A. 

AF, CT, DF, DN, EF, FN, NA, PN, R, TM, TY, and one date (either AD, CD, or MD) can be 

entered on a single PURGALL command. 

PURGE COMMAND 

The PURGE command names files to be removed from the permanent file device. 

Format: 

PURGE,pfn^,pfn 2 ,.••,pfnn/UN=username,PW=password,PN=packname,R=r,NA,WB. 

Parameter Description 

pfn^ Specifies the name of a permanent file to be purged. If no file is 

named, and if a permanent file exists that has the same name as the 
primary file, that permanent file is purged; the primary file remains 
assigned to the job. 
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The full descriptions of the following optional parameters are given at the beginning of 
this section. 


Parameter 


Description 


DN=msemame Specifies the user name. Specified if the file(s) to be purged is in 
another user's catalog. To purge a file, you must have write 
permission for that file. 

PW=password Specifies the file password. Specified if UN=username is specified, 
and if the permanent file to be purged has a password. 

PN=packname Specifies the auxiliary device name. Specified if the permanent file 
resides on an auxiliary device. 

k“r Specifies the device type. Specified if a removable auxiliary device 

on a device type other than the installation-defined default is to be 
used. 


NA 

WB 


Specifies the no abort option. If NA is specified, processing errors 
do not terminate the job. 

Specifies the wait—if—busy option. WB causes the job to wait for the 
mounting of disk packs and busy files. 


When a PURGE command is Issued for any direct access file, the file is purged and the 
permanent file catalog is altered accordingly. However, if the direct access file is 
attached to a job, it remains attached to the job until you return it. 


RECLAIM COMMAND 

The RECLAIM command performs a number of functions related to the transfer of NOS files 
between your job and a dump file. The dump file can be a magnetic tape or a mass storage 
(disk) file. Using RECLAIM you can selectively dump local or permanent files, retrieve 
files from a dump file, and list Information about files previously dumped to tape or mass 
storage. 

RECLAIM provides you with an easy way of making backup copies of local files or of direct 
and indirect access permanent files. It also gives you greater control over the size of 
your permanent file disk space. RECLAIM can be entered from a batch or interactive job. 

Dumped files can be reloaded as local or permanent files. Reloaded permanent files have the 
same permissions, modes, permit categories, and so forth that they had when dumped. Note, 
however, that file history information for reloaded files (that is, file creation date, last 
date modified, last date accessed, etc.) is set to the date and time of loading. Files can 
be reloaded from tape by the file owner or by an alternate user. 

Information about dumped files (such as file name, dump date, tape VSN, dump number, and so 
forth) can be stored in a dump database. This database is maintained as a direct access 
file in your permanent file catalog. RECLAIM automatically creates a dump database when you 
enter a DUMP directive unless you specify that you do not want a database for the dump 
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(using the DB=0 parameter). If you do not specify a name for the database, RECLAIM uses the 
default name RECLDB. To get information on individual files in the database, enter a 
RECLAIM command with the LIST directive. 

Multiple users can share a dump database. For example, alternate users can access a 
database in your catalog by entering a RECLAIM command specifying your database file name 
(on the DB parameter) and your user name (on the UN parameter). As with any other permanent 
file, alternate users must have WRITE permission to access and use your database file. 


MAGNETIC TAPES 

As previously mentioned, you can use RECLAIM to dump or retrieve files to or from magnetic 
tapes as well as mass storage media. You should be aware of the following special rules 
that apply when using tapes with RECLAIM: 

• You do not need to enter a REQUEST command for RECLAIM dump tapes. RECLAIM issues 
its own REQUEST command internally when you enter a COMPACT, DUMP, LOAD, or COPY 
directive (RECLAIM directives are described below). RECLAIM uses the default 
parameter values for the REQUEST command. 


I NOTE 


Since RECLAIM issues the REQUEST command 
internally, you must be prepared to wait for 
the tape mount if you enter a COMPACT, DUMP, 
LOAD, or COPY directive from an interactive 
job. Other alternatives are to submit the 
RECLAIM command from a batch job or to 
detach your interactive job using the Detach 
(ctD) command. 


• RECLAIM dump tapes must be labeled; unlabeled tapes are not permissible. 

• If you enter a LOAD, COPY, or LIST directive for a tape that is not already defined 
to the RECLAIM database, RECLAIM reads the entire tape and adds all files on the 
tape, or all files matching the specified user index if the UI processing option is 
specified, to the database. This feature lets you add the entire contents of a tape 
to the database without having to name each file individually. 

• The tape processing options listed under Processing Options in section 12 are valid 
for RECLAIM tapes. Processing options are specified with the PO option. 

• The permanent file tapes are written by the RECLAIM utility in a format compatible 
with both PFDUMP and PFLOAD. The NOS 2 Analysis Handbook describes these permanent 
file utilities. 


10-34 


60459680 H 




COMMAND FORMAT 


The parameters of the RECLAIM command are order-independent. The directives and the options 
are appended to the end of the command. 


NOTE I 

For sites using the Tape Management System 
(TMS), there are additional directive options 
available on the RECLAIM command which are 
not described in this manual. For a 
description of the RECLAIM command under TMS, 
refer to the NOS Version 2 Tape Management 
System (TMS) User Reference manual. 


Format; 


RECLAIM,p^ ,P 2 , . . . ,Pjj./directive 2 ,optionsj^/directive 2 ,optionS 2 /directivejj,optionSjj. 


Parameter 


Description 


Specifies any of the following optional parameters. 

Parameter Description 


DB=pfn Specifies the name of the direct access file 

that contains the RECLAIM database. The 
default file name for pfn is RECLDB. If a 
value of 0 is entered for pfn, no database 
is created or maintained. 


I=lfni 


L=lfn2 


NA 

NH 

NV 


Do not attach the database file before you 
call RECLAIM; RECLAIM attaches the file for 
you. 

Specifies the name of the local file 
containing the RECLAIM input directives to 
be processed. The default file name for 
Ifni is INPUT. 

Specifies the name of the local file to 
receive output listing. The default file 
name for lfn 2 is OUTPUT. 

No abort parameter. Inhibits RECLAIM abort 
in case of a program error. 

Inhibits RECLAIM from printing a header on 
file lfn 2 . 

Specifies that a dump is to be written at 
end-of-information (EOI), regardless of what 
precedes the EOI. If this parameter is 
OBiitted, RECLAIM will not write a dump 
beginning at EOI unless at least one valid 
RECLAIM dump precedes the EOI. 
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Parameter 


Description 


Parameter Description 

PN=packname Specifies the auxiliary device name. You 

specify packname only if the database file 
resides on an auxiliary device. 

PW=password Specifies the file password for the database 

file; applicable only if the database file 
resides in an alternate user catalog. 

R=devtype Specifies the mass storage device type for 

database residence. This parameter is 
applicable only if the PN parameter is also 
specified. If PN is specified but R is not, 
the system default device type specified by 
IPRDECK entry DFPT is used. 

UN=username Specifies the user name of the database file 

owner; applicable only if the database file 
resides in an alternate user catalog. You 
must have WRITE permission to access files 
under an alternate user name. 

Z Specifies that the RECLAIM command contains 

input directives following the terminator. 

If the Z parameter is specified, the I 
parameter is ignored. Use of the Z parameter 
eliminates the need for an input file (Ifni) 
when only a few directives are required. 

directive^ Specifies how RECLAIM is to manipulate files that meet the criteria 
set forth in the directive options. (RECLAIM directives and options 
are described below.) 

options^ Specifies a file characteristic or attribute RECLAIM is to use in 

selecting the file or files to be processed. (RECLAIM directives and 
options are described below.) Use a comma to separate individual 
options. 

RECLAIM directives define the operation to be performed on a specified file or files. All 
directives except END can have one or more associated options. A comma is used as the 
separator between a directive and its associated options. 

When you enter a RECLAIM command with the Z parameter, you type in the directives following 

the command terminator. The first character following the terminator must be the separator 

character used to separate individual directives. The separator character can be any 

character that does not appear within the directives. (We use the / character in the 

examples in this section.) 
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Following are descriptions of the RECLAIM directives. The description of the options for 
the directives immediately follows the description of the directives. 


Directive 

COMPACT 


Description 

Rewrites a dump file using only the active files from the database. 

All files logically deleted (using the DELETE directive) from your 
database are physically deleted from the dump file and the database. 
Options may also be specified which apply additional file selection 
criteria. Files which do not meet these additional criteria are also 
physically deleted. The database is updated to remove all inactive 
entries and update the dumpfile number for the remaining entries. 
COMPACT cannot be used on dump files that have no database file. 

The active files rewritten by the COMPACT directive are consolidated 
into a single dump before being rewritten; that is, the new dump file 
contains only one dump, unless existing dumps on the new dump file are 
preserved by specifying the El or EI=Y option. Files are written to 
the new dump file at beginning-of-information (file is rewound) unless 
El or EI=Y is specified. If El or EI=Y is specified and RECLAIM 
determines that a dump file is empty or does not contain a RECLAIM 
dump, it sends the following message to the dayfile and the terminal: 

UNKNOWN DUMP FILE WILL BE REWRITTEN. 

If the COMPACT directive was entered interactively, RECLAIM issues the 
prompt: 

IS THIS OK (YES OR NO)? 

If you enter YES, the COMPACT directive proceeds normally. For a NO 
response, RECLAIM ignores the directive and prompts for the next one. 
In a noninteractive job, RECLAIM proceeds with the COMPACT directive. 

You must specify one of the following options to indicate where the 
dump file to be created by COMPACT is to be stored: 

CF=clfn 

CN=cpfn 

CT=vsn 

OV 

Either or both of the CF=clfn and CN=cpfn options must be specified in 
conjunction with the DT=MS option if a new mass storage file is to 
receive the dump. 

The CT’^vsn option must be specified if a new tape is to receive the 
dump. If you intend to enter a COMPACT directive specifying a new 
tape, you must issue a RESOURC command to allow RECLAIM to request the 
two tapes at once. 
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Directive 


Description 


COPY 


DELETE 
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You must specify the OV option if the dump is to be rewritten on the 
original tape or file. To rewrite a dump tape, the compacted dump is 
first written to a disk scratch file, then copied to the original file. 

If the OV option is specified, the El or EI=Y option should not be 
used. If it is used, -it will be ignored. 

If you know or expect that a dump will require multiple reels, you 
must enter a VSN command before entering RECLAIM. The VSN command 
should specify as many VSNs as necessary and should associate the VSNs 
with the local file name specified by the CF option. If no CF option 
is specified, the default local file name NTAPE is used. 

Creates local file copies of all dumped files that meet the criteria 
specified by the COPY directive options. (The COPY directive is the 
same as the LOAD directive except that the LOAD directive creates 
permanent files from dumped files.) The copied files are created 
using their original permanent file names unless they are explicitly 
renamed. 

The COPY directive performs its own tape requests internally. If a 
copy is initiated for several files resident on a single tape, that 
tape is only requested once. If the copy specifies files on multiple 
tapes, multiple tape requests are initiated. 

The COPY directive can be used to read files from a tape that is not 
listed in the RECLAIM database. When used in this way, RECLAIM reads 
all files from the tape (regardless of how many files are specified by 
the COPY directive options) and adds all files to the RECLAIM database. 

The latest (most recently dumped) version of each file is copied 
unless you specify other characteristics. The following are examples 
of a COPY directive: 

RECLAIM,Z./COPY,PF=ALPHA/C0PY,PF=BETA/C0PY,PF=SIGMA 
or 

RECLAIM,Z./COPY,PF=*/ALPHA,BETA,SIGMA 

Either of the above commands copies the latest (most recently dumped) 
versions of files ALPHA, BETA, and SIGMA and makes them local files. 

Disables all files in your database that meet the criteria specified 
by the DELETE directive options. Deleted files are not physically 
deleted from the database and can be restored to active status using 
the RESET directive. Use the LIST directive with the DE option to 
list deleted files. You can use DELETE to temporarily disable 
selected files, thus allowing you to load all files except those 
disabled. All files disabled by DELETE are physically removed from 
the dump file if a COMPACT directive is entered before the disabled 
files are reactivated (using RESET). The following is an example of a 
DELETE directive: 

RECLAIM,Z./DELETE,DD=851204 

The above example Instructs RECLAIM to disable all files diunped on the 
date 12/4/85. 
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Directive 


Description 


DUMP Dumps to tape or mass storage all permanent files that meet the 

criteria specified by the DUMP directive options. Information that 
RECLAIM requires to perform future reloads from the dump file is 
stored in a database file within the specified user catalog. If the 
specified database file does not exist, RECLAIM creates it. You can 
inhibit the creation or use of a database file by specifying the DB=0 
parameter. 

Files are dumped in the order they appear in your permanent file 
catalog unless you specify the PF or FN option. Files are then dumped 
in the order they are listed for PF or FN. If a file is listed more 
than once for PF or FN, multiple copies are dumped, in the specified 
order. 

Files dumped are written to the dump file at EOI unless EI=N is 
specified. If RECLAIM determines that a dump file is empty or does 
not contain a RECLAIM dump, it sends the following message to the 
dayfile and the terminal: 

UNKNOWN DUMP FILE WILL BE REWRITTEN. 

If the DUMP directive was entered interactively, RECLAIM Issues the 
prompt: 

IS THIS OK (YES OR NO)? 

If you enter YES, the DUMP directive proceeds normally. For a NO 
response, RECLAIM ignores the directive and prompts for the next one. 
In a noninteractive job, RECLAIM proceeds with the DUMP directive. 

The following is an example of a RECLAIM DUMP directive: 

RECLAIM,Z./DUMP,TY=D,TN=001442 

This example Instructs RECLAIM to dump all direct access permanent 
files in your catalog to a magnetic tape with the VSN of 001442. If a 
database named RECLDB does not currently exist, RECLAIM creates it. 

If you know or expect that a dump will require multiple reels, you 
must enter a VSN command before entering the RECLAIM command. The VSN 
command should specify as many VSNs as necessary and should associate 
the VSNs with the local file name specified by the DF option. The 
default name is TAPE. For example: 

VSN,TAPE=001442/001501/001995. 

RECLAIM,Z./DUMP,TN=001442,TY=D 

The above example duplicates the previous example, but allows for a 
multi-reel dump. 
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Directive 

END 


LIST 


LOAD 


Description 


Ends the current RECLAIM session. At an interactive terminal, a blank 
line followed by a carriage return is equivalent to an END. In a 
directive file, an EOR has the same effect as an END directive. 

You can use the F tape processing option (refer to Processing Options 
in section 12) to instruct RECLAIM to unload a tape when the END 
directive is entered. To do this, enter the following SET directive 
before you initiate any operation that would cause a tape to be 
mounted (such as a COPY, DUMP, or LOAD): 

SET,PO=F 

Lists RECLAIM database information about all dumped files that meet 
the criteria specified by the accompanying directive options. Files 
are listed in alphabetical order except for dump files without a 
database. Dump files with no database are listed in sequential order. 

The LIST directive can be used to list files on a tape that is not 
listed in the RECLAIM database. When used in this way, RECLAIM adds 
all files on the tape to the RECLAIM database, regardless of how many 
files are specified by the LIST directive options. 

Loads into your permanent file catalog all of the files that meet the 
criteria specified by the LOAD directive options. (The LOAD directive 
is the same as the COPY directive except that the COPY directive 
creates only local files.) The latest (most recently dumped) version 
of each file is loaded unless you specify other characteristics. If a 
file name specified in a LOAD directive already exists in the catalog, 
the file will not be loaded unless the RP or RP^Y option is also 
specified. 

The LOAD directive can be used to load files from a tape that is not 
listed in the RECLAIM database. When used in this way, RECLAIM loads 
all files from the tape (regardless of how many files are specified by 
the LOAD directive options) and adds all files to the RECLAIM database. 

The LOAD directive performs its own tape requests internally. If a 
load is initiated for several files resident on a single tape, that 
tape is only requested once. If the load specifies files on multiple 
tapes, multiple tape requests are initiated. Following are examples 
of the LOAD directive: 

RECLAIM,Z./LOAD,PF=MYFILE 

The above LOAD directive loads into your catalog the most recently 
dumped version of MYFILE, 

RECLAIM,Z./LOAD,DD=840112,NF=5 9 5 

The above LOAD directive loads up to 595 files dumped on the date 
1/12/84. 
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Directive 


Description 


QUIT 

REMOVE 


RESET 

SET 


RECLAIM,Z./LOAD,PF=ALPHA,NN=BETA,MD=831114 
or 

RECLAIM,Z./LOAD,PF=*,MD=831114/BETA=ALPHA 

Either of the previous LOAD directives loads the latest version of 
file ALPHA with a modification date of 11/14/83. File ALPHA is loaded 
into your catalog as file BETA. If a permanent file called BETA 
already exists in your catalog, the file is not loaded. If a 
permanent file named ALPHA exists in the catalog, it does not affect, 
and is not affected by, this operation. 

Equivalent to END. 

Permanently removes a tape volume serial number (VSN) from the 
database. This purges from the database all entries for the specified 
tape. 

Reactivates all files previously disabled by the DELETE directive that 
meet the criteria specified by the RESET directive options. 

Redefines the RECLAIM defaults for any directive options. Typically, 
this directive is used during a long RECLAIM session to establish 
criteria for subsequent processing. If a SET directive is encountered 
without an accompanying option, it has no effect on current defaults. 
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The options that can be associated with RECIAIM directives are described below. 


Potion 


AA=yyimndd 


AB=yyinmdd 


AD=yyinmdd 


ASspption 


CF=clfn 


CN=cpfn 


CT=vsn 


Description 

Instructs RECIAIM to process only those files accessed after a 
specified date. The AA option may be used in conjuction with AB to 
specify a date range. The cation is used with DUMP. If DB=0, it may 
also be used with COPY, LIST, cuad LOAD. 

Instructs RECLAIM to process only those files accessed before a 
specified date. The AB option may be used In conjuction with 7VA to 
specify a date r 2 tnge. The option is used with DtIMP. If DB=0, it may 
also be used with COPY, LIST, and LOAD. 

Instructs RECLAIM to process only those files accessed on a specified 
date. The AD option is used with DUMP. If DB=0, it may also be used 
with COPY, LIST, and LOAD. 

Determines whether RECLAIM preserves permanent file catalog data 
relating to alternate storage residing on tape or cartridge. Use only 
with the DDMP directive. Specify Y to preserve catalog information; 
specify N to discard information. The default is N. 

When H is specified, alternate storage data is cleared on the dun^ 
tape. Use the AS=Y option only when you need to PFLQAD a dun^ tape 
generated by RECLAIM. 

Specifies the name of the local file to receive the compacted dusp. 

If clfn is omitted, the local file name is the name specified for the 
CN parameter. If the CN parameter is omitted, the default name NTAPE 
is used for clfn. This option is used with COMPACT. 

Specifies the permanent file to receive the conpacted dtmp if you do 
not want to overwrite the original duirp file. (Use the OV option to 
overwrite the original dvmp file.) The CN option allows you to 
specify different names for the local and permanent file copies of the 
dunp file. This option does not create, save, or replace the 
permanent file. These cperations are the user's responsibility. This 
option is used with CC^IPACT. 

Specifies the VSN of the tape to which the conpacted dunp is to be 
written. The CT option is used with COMPACT. 
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Option 


D=den 


DA=yyinmdd 


DB=yyinmdd 


DD=yytnmdd 


DB 


DF=dlfn 


DN=dp£n 


Deecription 

Specifies tape density. Values that can be specified for den are as 
follows: 


den 


Descriotion 




HI 

556 

cpi; 

7-track tape 

(MT) 



HY 

800 

cpi; 

7-track tape 

(MT) 



HD 

800 

qpi; 

9-track tape 

(NT) 



PE 

1600 

cpi; 

9-track tape 

INT) 



GE 

6250 

cpi; 

9-track tape 

(NT) 



AE 

38000 

cpi; 

ceurtridge tape for 

ACS 

(AT) 

CB 

38000 

cpi; 

cartridge tape for 

CTS 

(CT) 


The D option is used with COMPACT euid DDMP. 

Instructs RECLAIM to process only those files dunped after a specified 
date. DA may be used in conjunction with DB to specify a date range. 
The DA option is used with COMPACT, COPY, DELETE, LIST, LOAD, and 
RESET. 

Instructs RECLAIM to process only those files dunked before a 
specified date. DB may be used in conjvmction with DA to specify a 
date range. The DB option is used with COMPACT, COPY, DELETE, LIST, 
LOAD, and RESET. 

Instructs RECLAIM to process only those files dimmed on a specified 
date. The DD option is used with COMPACT, COPY, DELETE, LIST, LOAD 
and RESET. 

Instructs RECLAIM to process only those files disabled by DELETE. If 
this option is emitted, only undeleted files are processed. Ihe DE 
option is used with COMPACT, COPY, LIST, LOAD, and RESET. 

Specifies the name of the local file copy of a dusp file. The default 
naune for dlfn is TAPE. The DF cation is used with DDMP. 

Specifies the file to or from which files are to be processed. Only 
files on this duxi^ file that meet other specified selection criteria 
are selected. The DM option is logically equivalent to emd 
interchangeable with the TN option except if a DT, MT, or NT option is 
not specified. In this case, DN inplies a mass storage dua^ file 
while TN inplies a tape dun^ file (therefore, TN causes RECLAIM to 
issue an internal REQUEST command, whereas DN does not) . The DN 
option is used with COMPACT, COPY, DELETE, DUMP, LIST, LOAD, and 
RESET. 

If the DN option (or DTsHS) is used for a DUMP operation, RECLAIM does 
not make the mass storage dus^ file permanent. If you wish to make 
the dunp file permanent, you may do so. However, the dump file must 
be local before you can use it with RECLAIM. 


10-40 


60459680 P 




Option 


Description 


DT^dtype 


EI=option 


EX=option 


F=foritiat 


FI=nn 


Specifies the type of dump file to be created. Possible values for 
dtype are: 


dtvpe Description 


AT 

The 

dusp 

is 

placed 

on 

a cartridge tape 

for ACS 

• 

CT 

The 

duirp 

is 

placed 

on 

a cartridge tape 

for CTS 

• 

MS 

The 

dunp 

is 

placed 

on 

a mass storage (disk) file. 

MT 

The 

dump 

is 

placed 

on 

7-track magnetic 

tape. 

(Same 


as MT option.) 





NT 

The dun^j 

is 

placed 

on 

9-track magnetic 

tape. 

(Same 


as NT option.) 


The DT option is used with COMPACT and DUMP. 

Specifies whether RECLAIM is to write dunked files at the beginning of 
the dunp file or write dvmped files at the end of the dun^ file. 

option Description 

y Files are to be written to the dxM^j file at end-of* 

information. 

N Files are to be written to the dun^s file at 

beginning-of-information, thus destroying any 
existing information on the dunp file. 

If El appears alone, it is equivalent to EI=Y. If El is omitted, DUMP 
processing assumes EI=Y; COMPACT processing assumes EIsN. The El 
option is used with COMPACT and DUMP. 

Specifies the use of exception processing for RECLAIM options. Values 
that cetn be specified for option are Y or N. Y indicates that 
exception processing is used; that is, only files that fail one or 
more selection criteria cure processed. N indicates that normal 
processing is used; that is, only files that meet all selection 
criteria are processed. The EX option is used with COMPACT, COPY, 
DELETE, DUMP, LIST, LOAD, and RESET. 

Specifies any valid NOS tape format. The F option is used with 
COMPACT or DUMP. 

Specifies the dunp ninnber (1 to 63) to which the dunp file is to be 
positioned. A dvaap is the set of user files dusped to a file by a 
single DUMP or COMPACT directive. 

The FI option can be used in conjunction with the RC option to 
position the tape or file pointer to a particular file within a 
specified dunp. (The FI value associated with a particular file is 
listed in the FI column of the RECLAIM output listing.) The FI option 
is used with COPY and LOAD. 
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Option 


FN=filename 


FT 


GT=length 


LT=length 


LV 


MA.=yyinmdd 


MB»yyiiimdd 


MD=yynmdd 


MT 


Description 


Processes files in the same manner as the PF option with one 
exception: When used with a DUMP directive, it first checks to see if 
a named file exists as a local file. If so, the local file is dumped. 

The TY option can be used with FN to specify whether named local files 
are to be dumped as direct access or indirect access files. The 
default is direct access. 

The FN option is used with COMPACT, COPY, DELETE, DUMP, LIST, LOAD, 
and RESET. For all directives except DUMP, the FN and PF options are 
Interchangeable. 

Foreign tape. Refer to the NOS 2 Tape Management System (TMS) User 
Reference Manual for a detailed description. 

Instructs RECLAIM to process only those files that have a length in 
PRUs greater than the length specified. GT may be used in conjunction 
with LT to specify a size range. The GT option is used with COMPACT, 
COPY, DELETE, DUMP, LIST, LOAD and RESET. 

Instructs RECLAIM to process only those files that have a length in 
PRUs less than the length specified. LT may be used in conjunction 
with GT to specify a size range. The LT option is used with COMPACT, 
COPY, DELETE, DUMP, LIST, LOAD and RESET. 

Specifies that the most current version of the specified file is to be 
processed. This is the default for the COPY and LOAD directives. The 
LV option is used with COMPACT, COPY, DELETE, LIST, LOAD and RESET. 

Instructs RECLAIM to process only those files modified after a 
specified date. MA may be used in conjunction with MB to specify a 

date range. The MA option is used with COMPACT, COPY, DELETE, DUMP, 

LIST, LOAD and RESET. 

Instructs RECLAIM to process only those files modified before a 
specified date. MB may be used in conjunction with MA to specify a 

date range. The MB option is used with COMPACT, COPY, DELETE, DUMP, 

LIST, LOAD and RESET. 

Instructs RECLAIM to process only those files modified on a specified 
date. The MD option is used with COMPACT, COPY, DELETE, DUMP, LIST, 
LOAD and RESET. 

Specifies the use of a 7-track tape drive. The MT option is used with 
DUMP. 


NA 


NF«num 


NN=pfn 
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Instructs RECLAIM to not abort when one or more of a list of 
specified files cannot be found or fails to meet the other criteria. 

The NA option has no effect on other errors. Use this option with 
COMPACT, COPY, DELETE, DUMP, LIST, LOAD, and RESET. 

Specifies the maximum number of files to be processed. If the NF 
option is omitted, there is no limit on the number of files processed, 
except for the DUMP directive. The limit for DUMP is 4095 files. The 
NF option is used with COMPACT, COPY, DELETE, DUMP, LIST, LOAD and 
RESET. 

Specifies a new file name for the file named by the PF option. The NN 
option is used with COPY, DUMP and LOAD. 
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Option 


Description 


NT 

OV 

PF-pfn 


P0“plp2.• .pn 

PW“password 

RC=nnnn 


Specifies the use of a 9-track tape drive. The NT option is used with 
DUMP. 

Specifies that a compacted dump is to be written over the old dump 
tape. The OV option is used with COMPACT. 

Specifies the name of the permanent file or files to be processed by 
RECLAIM. If only one file is to be processed, pfn is any valid NOS 
file name. If PF and FN are both omitted, the files to be processed 
are determined by the other options which have been specified. If 
multiple files are to be selected by name, specify an asterisk (*) for 
pfn. 

When PF=* is specified, a file name list containing up to 999 file 
names may be entered. A line of file names ending with a comma 
indicates that the file name list is continued on the next line. For 
interactive requests, RECLAIM prompts you to enter the file names with 
the message: 

ENTER FILE NAMES. 

The file name list contains one entry for each file to be processed. 
Each entry consists of the name of the file to be processed, unless 
the file is to be renamed. If the file is to be renamed, the entry is 
in the format, newname=oldname. Entries are separated by commas. An 
entry not followed by a separator indicates the end of the list. A 
comma at end of line indicates that another line follows. 

Following is an example of a file name list: 

RECLAIM, Z . /DUMP, TN=MYVSN, PF=*/ALPHA, GAMMA=BETA 

This command will cause RECLAIM to dump files ALPHA and BETA. The 
files will be identified in the dump and in the database as ALPHA and 
GAMMA. The PF option is used with COMPACT, COPY, DELETE, DUMP, LIST, 
LOAD and RESET. 

Specifies general tape processing options for a dump tape. Refer to 
Processing Options in section 12 for a description of dump tape 
processing options. Options I, P, and S are not accepted by RECLAIM. 
The PO option is used with COMPACT, COPY, LIST, LOAD, DUMP, and SET. 
The PO option is seldom required, as the RECLAIM defaults cover most 
situations adequately. PO=UR is the default for the COPY, LIST, and 
LOAD directives. PO=UW is the default for the COMPACT and DUMP 
directives. 

Password. Refer to the NOS Version 2 Tape Management System (TMS) 

User Reference manual for a detailed description. 

Specifies the dump record number (1 to 4095) within a dump that 
indicates where the dump file is to be positioned. The RC option is 
used in conjunction with the FI option to specify the location of a 
file within a dump. (The RC value associated with a particular file 
is listed in the REC column of the RECLAIM listable output.) The RC 
option is used with COPY and LOAD. 
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Option 

RP=qption 


RS=option 

TN=vsn 

TO=usemaine 

Ty=type 

UI=user 

index 

UNsusername 


Description 

Specifies that a file is to be loaded or copied fron a dump file, even if 
a local or permanent file by the same name already exists. Values for 
option are Y, N, or C. The RP option is used with COPY and LOAD. Hhen 
used with the lOAD directive, specifying RP or RP=Y indicates that am 
existing permanent file will be replaced by a file loaded from a dunp. 
Specifying RP=N or esnitting the RP option indicates that an existing 
permanent file will not be replaced by a loaded file. 

When used with the COPY directive, specifying RP or RP=y indicates that a 
local file will be rewound and overwritten by a file copied from a dunp. 
Specifying RP=C indicates that a file from a dunp will be ccpied to an 
existing local file at its current location. If RP=1I is specified, or if 
the RP option is omitted, RECLAIM returns the existing local file before 
copying the file from DUMP. 

Specifies the media on which the files to be dunped must reside. Specify 
C to dunp only files that reside on MSE or qptical dish; specify D to dtmp 
only files that reside on disk; or specify T to dvmp only files that 
reside on tape. You Ceui specify more than one residence criteria. For 
exanple, RSsCD selects files that reside on either disk, MSE, or optical 
disk. If RS is omitted, file residence is not used as a criterion for 
files to be dumped. The RS cption is used only with the DUMP directive. 

Specifies the VSN of the tape to or frcm which files are to be processed 
(VSM of the first volumie for a multivolume dump) . Only files on this tape 
which also meet ^^ly other specified selection criteria are processed. 

This option is logically equivalent to and interchangeable with the DN 
option except if a DT, MT, or MT option is not specified. In this case, 

DN inplies a mass storage dump file while TN implies a tape dump file 
(therefore, TN causes RECLAIM to issue an internal REQUEST command, 
whereas DN does not). The TN option is used with COMPACT, COPY, DELETE, 
DUMP, LIST, LOAD, RESET and SET. 

User name. Refer to the NOS Version 2 Tape Hcuiagement System (TMS) User 
Reference manual for a detailed description. 

Specifies the pemanent file type to be processed. Values that can be 
specified for the TY option are: D (direct access) and I (indirect 
access). If this option is omitted, both file types are eligible for 
processing. The TY option is used with COMPACT, COPY, DELETE, LIST, LOAD, 
cuad RESET. 

Instructs RECLAIM to process only files for the specified user 
index when the COPY, LIST, or LOAD directive is used to process a dunp 
tape or file not on the database, or when no database is being used 
(DB-0) . If this option is either omitted or specified as UIsO, the user 
index of files on the dunp tape or file being processed will be ignored. 

Instructs RECIiAIM to process files only for the specified user name on the 
RECLAIM datcibase, when files are shared among multiple users. If this 
option is emitted, processing is performed only on the calling user's 
dunped files. Files for all users will be processed if UNsO is specified. 
The DN option is used with COMPACT, COPY, DELETE, LIST, LOAD and RESET. 

If the UN option specifies a user name not originally in the RECLAIM 
database, RECLAIM loads all files (LOAD directive) or lists information 
about all dunped files (LIST directive) on a file set specified by the TN 
or DN options. Loaded files are recorded in the database imder the user 
name specified by the UN option. 
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RECLAIM OUTPUT 


All RECIAIH directives except END, QUIT emd SET generate output listings in the following 
format: 


RECIiAIH Vwv OPsddddddd UNsusemame yy/mm/dd. hh.mm.ss. PAGE nn 
PFN TYPE LAST MOD DOMP DATE LENGTH USERNAME TAPE FI REC 


pfname ty yy/tnm/dd yy/mm/dd 
pfname ty yy/mm/dd yy/mm/dd 


len dn^user duspid fi rc 
len dnpuser dtmpid fi rc 


n FILES PROCESSED 


where: 


vw 

ddddddd 

username 

nn 

pfname 

ty 

len 

dmpuser 

dunpid 


fi 

rc 


Current version of RECLAIM. 

Name of the RECLAIM directive being processed. 

User name of the calling user. 

Current page number (not displayed for interactive users). 

Name of the permanent file being processed. 

File type (I for indirect access or D for direct access). 

Length in PRUs of file pfname when dumped. 

The user name mder which file pfname was originally dumped. 

VSN of the tape or name of dump file containing file pfname (VSN of 
the first reel for a multivolume dunp). 

The dump number on duopid containing file pfname. 

The record number on dunp fi containing file pfname. 


Entering a RECLAIM command with the NH parameter specified suppresses printing of the 
heading and the n FILES PROCESSED line; only the file information is printed. 


Exanple 1 

The following RECLAIM conmand lists a portion of dunp file database M)fDB, and terminates the 
RECLAIM session. 

/reclaim, db=ntydb, z. /list, tn=01/end 
RECLAIM V4.2 OP=LIST UN=OMEN 83/12/14. 13.03.34. 

PFN TYPE LAST MOD DUMP DATE LENGTH USERNAME TAPE FI REC 

DEMA I 83/11/18 83/12/13 187 OMEN 01 12 

DEMB I 83/11/18 83/12/13 27 OMEN 01 11 

2 FILES PROCESSED. 

RECLAIM COMPLETE. 

/ 
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REPLACE COMMAND 


The REPLACE connaand can purge an indirect access permanent file and replace it with a copy 
of a local file on mass storage. It can also save a copy of a local file on mass storage as 
a new Indirect access permanent file. 

Format: 

REPLACE,Ifn]^=pfn| ,lfn2=pfn2.lfnjj=pfnjj/UN “username,PW=password,M=m, 

PN=packname,R=r, NA,WB. 

Parameter Description 

lfn£=pfnj^ Specifies that a copy of local file Ifnj^ becomes an indirect access 
permanent file named pfiij^ (one- to seven-character name). If an 
indirect access file named pfn^ already exists, it is replaced. 

If Ifn^ is omitted, the name of the local file is assumed to be 
pfn^^. If no files are named, a copy of the primary file becomes an 
indirect access permanent file, replacing any existing indirect access 
permanent file by that name. 

The full descriptions of the following optional parameters are given at the beginning of 
this section. 

Parameter Description 

UN=username Specifies the user name. Specified if the file to be replaced is in 

another user's catalog. To replace another user's file, you must have 
write permission and be validated to create indirect access peirmanent 
files (refer to LIMITS Command in section 7). 

PW=password Specifies the file password. Specified if the UN“usemame is 

specified, and if the permanent file to be replaced has a password. 

M=m Specifies the file access mode if the file does not already exist, or 

if you want to change the access mode. If M=m is omitted for a newly 
created file, M=READ is assumed. If the parameter is omitted for a 
previously existing file, the current access mode is retained. 

PN=packname Specifies the auxiliary device name. Specified if the permanent file 
to be replaced resides on an auxiliary device. 

R®'!' Specifies the device type. Specified if a removable auxiliary device 

on a device type other than the installation-defined default is to be 
used. 

Specifies the no abort option. If NA is specified, processing errors 
do not terminate the job. 

WB Specifies the wait-if-busy option. The job waits for the mounting of 

disk packs. 

The local files, Ifn^;^, are rewound before and after the replace operation. 

The indirect access file created has the same access category as the file it replaces. 
Permission information and alternate user access data for the file are retained when a file 
is replaced. If the file created is a new file, it is created as a private file. 
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SAVE COMMAND 


The SAVE command retains a copy of a local file on mass storage as an indirect access file. 
When you save a file using this command, the charge number and project number currently in 
effect for your job are associated with the file. 

Format: 


SAVE,lfni=pfni,lfn 2 =pfn 2 ,...,lfnjj=pfnji/PW=password,CT=ct,M=m,SS=subsystem, 
BR=br,PR=pr,PN=pack.name,R=r,NA,WB,AL=level,XD=expiredate,XT=expireterm,AC=ac. 

Parameter Description 


lfni=pfn£ Specifies that a copy of local file Ifnj^ becomes an indirect access 
permanent file named pfnj (one- to seven-character name). If 
lfn;j^= is omitted, the name of the local file is assumed to be 
pfn^. If no files are named, a copy of the primary file becomes an 
Indirect access permanent file with the same name as the primary file. 

The full descriptions of the following optional parameters (except M=m) are given at the 
beginning of this section. 


Parameter Description 


PW=passwrd Specifies the one- to seven-character password that other users must 
specify to access the file. 

CT=ct Specifies the file permit category; entries are P, PR, or PRIVATE for 

private; S or SPRIV for semiprivate; and PU or PUBLIC for public. If 
CT=ct is omitted, CT=PRIVATE is assumed. 


M=m 


Specifies the file access mode permitted to other users if the file is 
public or semiprivate, and if explicit access permission has not been 
granted to that user. If M=m is omitted, M=READ is assumed. 


If m is: 

R or READ 
RU or READUP 
RA or READAP 
RM or READMD 
U or UPDATE 

E or EXECUTE 


A or APPEND 
M or MODIFY 


W or WRITE 

N or NULL 


Other users can: 

Retrieve a copy of the file. This copy can 
be read or executed. 


Retrieve a copy of the file. This copy can only 
be executed. 

Append data to the file with the APPEND command. 

Retrieve a copy of the file or append data to 
the file. The user can enter GET, OLD, NEW, and 
APPEND commands, but not a REPLACE command, for 
the file. 

Retrieve a copy of the file, append data to it, 
replace it, or purge it. 

No access is allowed. 
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Parameter 


SS=subsyBtem Specifies the interactive subsystem associated with the file. This 
subsystem beccanes associated with the permanent file pfn, and is 
selected automatically each time the file is retreived for use as a 
primary file. If SS=subsystem is omitted, SS=NDIii:i is assumed unless 
Ifn is the primary file. In that case, the file is associated with 
the currently active subsystem. If SS is specified without a 
stibsystem, the file is associated with the currently active 
subsystem. 

BR=br Specifies the backup copy requirement; possible values are HD (one 

bacScup copy required), N (no backup), or Y (two backup cc^ies 
required) . If BR=br is emitted, BR=Y is asstimed. 

PR=pr Specifies the preferred file residence; possible values are D (disk 

residence preferred), L (locked to disk) , M (MSB or optical disk 
residence preferred), N (no preference), or T (tape alternate storage 
residence preferred) . If PR=pr is omitted, PR=H is assimied. 

PN=packname Specifies the name of the auxiliary device on which the indirect 
access file is to reside. 

R=r Specifies the device type on which the indirect access file is to 

reside. The device must be a permauient file mass storage device on 
which indirect access files are allowed. 

NA Specifies the no abort option. If NA is specified, processing errors 

do not terminate the job. 

WB Causes the job to wait for the mounting of disk packs. 

AL=level Specifies the security access level you want assigned to the file. 

Unless changed by your site, level can be one of the following names: 

LVLO, LVLl, LVL2, LVL3, LVI,4, LVL5, LVL6, or LVL7 
The default is the access level of the local file being saved. 

XD=e]q)iredate Specifies the e^qjiration date for the file password. The value 

expiredate must be a 6-digit string of the form yymmdd; where yy, mm, 
and dd are 2-digit year, month, and day designators, respectively. 

You can specify this parameter only if you also specify the 
PHspassword parameter. 

XTsexpireterm Specifies the life of the file password in days. If you specify 0, 

the file password e}q)ires immediately. If you specify 4095 or *, the 
file password does not ei^ire. You can specify this parameter only 
if you also specify the PHcpassword parameter. 

AC=ac Specifies whether alternate users may obtain information about the 

file using CATLIST. Entries are Y (yes) and H (no). The default 
is N. 

The local files, Ifni, are rewound before and after the save operation. 
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SETPFAC COMMAND 


The SETPFAC ccxnnand changes the set of security access categories associated with a 
permanent file. You can either specify an entirely new category set or add to or delete 
frcan the current category set. By default on a secured system, the system associates all of 
the access categories for which you are authorized to any permanent file you create. 

Format: 

SETPFAC, pfn,AC=0, category , category 2 categoryjj/PN=packname, R=r, NA, WB. 

or 


SETPFAC,pfn,AC=categoryi,category 2 , .. .,categoryjj/PN=packname,R=r,NA,WB. 

Parameter Description 

pfn Specifies the permanent file whose access category set you want to 

change. 

AC=0,... Specifies a new category set. Unless chcuiged by your site, categoryi 

category... can be any of the following names: 

CATOO,CATOl,...,CAT31 


ACa:... Specifies categories to add or delete from the current category set. 

category... To add a category, prefix the category name with a plus sign or use 

no prefix at all. To delete a category, prefix the category ncune with 
a minus sign. 


PH=packname Specifies the auxiliary device name. You must specify this parcuneter 
if pfn resides on an auxiliary device. 


Rsr Specifies the device type. You must specify this parameter if a 

removable auxilisury device on a device type other than the 
installation-defined default is to be used. 


NA Specifies the no abort option. If KA is specified, processing errors 

do not terminate the job. 

WB Specifies the wait-if-busy option. WB causes the job to wait for the 

mounting of disk packs. 

The first format creates a new access category set. The second format adds to or deletes 
frcan the current category set. 

On a secured system, the categories you specify must be valid for your job (ENQUIRE,B 
returns this information). On an unsecured system, the system does not use the categories 
to monitor access to the file but does maintain the categories as a file attribute. 
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SETPFAL COMMAND 


The SETPFAL conmand changes the security access level of a permanent file. By default, a 

direct access file inherits the access level of the creating joh. An indirect access 

permanent file inherits the access level of the local file from which it was created. You 
can also explicitly set the access level when you create a permanent file by specifying the 
AL=level parameter on the command you use to create the file. 

Format: 

SETPFAL,pfn,AL=level/PN=packname,R=r,NA,WB. 

The first two parameters are required and are order-dependent. 

Parameter Description 

pfn Specifies the permanent file whose access level you want to change. 

AL=level Specifies the security access level you want assigned to the file. 

Unless changed by your site, level can be one of the following names: 

LVLO, LVLl, LVL2, LVL3, LVL4, LVL5, LVL6, or LVL7 

PN=packname Specifies the auxiliary device name. You must specify this parameter 
if pfn resides on an auxiliary device. 

R=r Specifies the device type. You must specify this parameter if a 

removable atujiliary device on a device type other than the 
installation-defined default is to be used. 

HA Specifies the no abort option. If NA is specified, processing errors 

do not terminate the job. 

WB Specifies the wait-if-busy option. WB causes the job to wait for the 

mounting of disk packs. 

On a secured system, the access level you specify must be valid for the job (ENQUIRE,B 
returns this information). In addition, to lower the access level of a file, you must be 
authorized to do so (refer to the LIMITS command). 

On an unsecured system, the system does not use this access level assignment to monitor 
access to the file but does maintain this assignment as a file attribute. 
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LOAD/DUMP MEMORY COMMANDS 


n 


The load/dump memory commands transfer information that resides in your job field length to 
a local file or transfer Information from a load file into your job field length. The 
following commands are included in this category. 


DMB 

DMP 

LOG 

WBR 

DMD 

DMPECS 

PBC 


DMDECS 

LBC 

RBR 



NOTE 


For information concerning security restric¬ 
tions associated with the use of these 
commands, refer to Security Control in 
section 3. 


The DMB command dumps the exchange package, central memory, and extended memory in binary. 
The DMP and DMD commands dump the exchange package or central memory in octal representation 
or display code equivalences. Likewise, the DMDECS and DMPECS commands dump extended 
memory. These commands are particularly helpful in creating dumps for debugging purposes 
(refer to volume 2, Guide to System Usage). Other transfers of data from central memory use 
the PBC command, which dumps a binary record to PUNCHB, and the WBR command, which writes a 
binary record on a specified file. 

Data is loaded to central memory by the LBC, LOG, and RBR commands. The LBC command is 
useful in loading binary data in an unknown format. 

All numeric parameters for these commands may be expressed in octal (postradix is B) or 
decimal (postradix is D) notation. If no radix is specified, octal is assumed. 


DMB COMMAND 

The DMB command generates a binary dump of the exchange package, central memory, and 
extended memory associated with the current job. File ZZZZDMB receives the dump and is not 
rewound before or after the dump. If ZZZZDMB is assigned to the terminal before the dump, 
the system returns it and creates a mass storage file by that name. Each dump creates one 
logical record on ZZZZDMB. Refer to Express Deadstart Dump Interpreter in the NOS 2 
Analysis Handbook for a description of how file ZZZZDMB can be formatted into a report. 

Format: 

DMB,ordinal,xmemory. 
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Parameter 


ordinal 


xmemory 


Description 


Specifies the dump record name. The system appends this parameter to 
the letter D to form a seven-character dump record name. Allowable 
values of ordinal are 0 through 7777778. if the parameter ordinal 
is greater than 377777 the job aborts after the dump completes. 

If you omit this parameter or specify a null entry, the record name 
becomes DOOOOOO. 

Determines whether the system dumps the extended memory assigned to 
the job. The parameter xmemory can be any whole number. If xmemory 
is zero or is omitted, the system dumps only the exchange package and 
central memory assigned to the job. If xmemory is nonzero, the system 
also dumps the extended memory assigned to the job. 
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iCiii 


DMP, DMDECS, DMPECS, or EXIT) 
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59 41 0 



If an extended memory error occurs, the block in error will be filled with 4000 
words of the following format: 


59 11 0 



The variable items in the preceding display have the following descriptions: 
item Description 


n 

m 

nnnn 


pgnr 


ccdr 


Octal number of central memory words assigned to the job. 
Octal number of extended memory words assigned to the job. 
Space (display code value 55g). 

Word number of the block in error (starting with 1). 

Name of the system program called by DMB. Words 4 and 10 
are blank-filled. 

An image of RA+70 to SA+75 of the field length dvimped. This 
is usually a copy of the command being executed prior to the 
dump. 
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DMD COMMAND 

The DMD cotnmand requests a dump similar to that of the DMP command but adds the display code 
equivalences to the right of the octal representations. If lines are duplicated, they are 
suppressed and an informative message is issued to the output file. 

Formats: 

DMD,fwa,Iwa. 

DMD,Iwa. 

DMD. 

Parameter Description 

fwa Specifies the first word address of memory to be dumped; fwa is 

relative to RA. If fwa is absent, dump mode depends on the presence 
or absence of Iwa. 

Iwa Specifies the last word address plus one of memory to be dumped; Iwa 

is relative to RA. If Iwa alone is present, DMD assumes fwa is 0. If 
neither fwa nor Iwa is present, DMD dumps the exchange package and 
40g locations before and after the program address in the exchange 
package. Only the lower 17 bits of the program address are used. 

You must not place another command (other than DMD, DMB, DMP, DMDECS, DMPECS, or EXIT) 
between the program to be dumped and the DMD command. 

In batch jobs, the dump is written on file OUTPUT. Central memory dumps are written four 
words per line. 

In interactive jobs, DMD is effective only within procedure files or when specified on the 
ENTER command. A diunp from a terminal is formatted for 72-column output and written on 
local file ZZZDUMP. DMD displays an informative message at the terminal. ZZZDUMP is not 
rewound before or after the dump. 
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DMDECS COMMAND 


The DMDECS command requests a dump of extended memory on file OUTPUT. The dump is four 
words per line with display code equivalences to the right of the octal representations. If 
lines are duplicated, they are suppressed and an informative message is issued to the output 
file. 


"note I 

The DMDECS command can dump only up to two 
million words of extended memory. If you 
want to dump more than two million words, 
use the DMB command (described in this 
section). 


Formats: 

DMDEC S,fwa,Iwa. 

DMDECS,Iwa. 

Parameter Description 


fwa Specifies the first word address of extended memory to be dumped; fwa 

is relative to the reference address of the field in extended memory 
being used by the job (RAE). If fwa is absent, DMDECS assumes fwa is 

0 . 

Iwa Specifies the last word address of extended memory to be dumped; Iwa 

is relative to RAE. 

The DMDECS command must immediately follow a program to be dumped, except that another 
DMDECS or a DMPECS, DMB, DMP, DMD, or EXIT command may intervene. 

Dumping always stops at the field length in extended memory (FLE) if Iwa is greater than 
FEE. 

If fwa is greater than FLE, fwa is set to FLE-10. If both fwa and Iwa are greater than FLE, 
fwa is set to FLE-10 and Iwa is set to FLE. 
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DMP COMMAND 

The DMP command can request an exchange package dump or a central memory dump. 

Formats: 

DMP,fwa,lwa. 

DMP.lwa. 

DMP. 

Parameter Description 

fwa Specifies the first word address of memory to be dumped; fwa is 

relative to the first word of the job's field length. If fwa is 
absent, the resulting dump depends on the presence or absence of Iwa. 

If fwa is greater than the job's field length, fwa is set at the job's 
field length minus lOg. If fwa is greater than or equal to 
400000g, the first dump address is fwa minus 400000g, memory from 
the first dump address through Iwa is dumped, and the job is aborted. 

Iwa Specifies the last word address plus one of memory to be dumped; Iwa 

is relative to the first word of the job's field length. If Iwa alone 
is present, DMP assumes fwa is 0. If neither fwa nor Iwa is present, 
DMP dumps the exchange package and 40g locations before and after 
the address in the program address register in the exchange package. 
Only the lower 17 bits of the program address are used. If Iwa is 
greater than the job's field length, the dump stops at the end of the 
field length. 

If either fwa or Iwa is nonnumeric, DMP dumps the exchange package and 40o locations 
before and after the program address register in the exchange package. If both fwa and Iwa 
are greater than the job's field length, the last lOg words of the job's field length are 
dumped. If fwa equals Iwa, the lOg words beginning at fwa are dumped. If fwa is greater 
than Iwa, DMP issues an error message and terminates the job step. 

You must not place another command (other than DMB, DMP, DMD, DMPECS, DMDECS, or EXIT) 
between the program to be dumped and the DMP command. 

DMP suppresses duplicate lines and then issues an informative message. In batch jobs, the 
dump is written on file OUTPUT. Central memory dumps are written four words per line. 

In interactive jobs, DMP is effective only within procedure files or when specified on the 
ENTER command. A dump from a terminal is formatted for 72—column output and written on 
local file ZZZDUMP. DMP displays an informative message at the terminal. ZZZDUMP is not 
rewound before or after the dump. 
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DMPECS COMMAND 


The DMPECS command dumps the contents of extended memory of a job's field length on file 
OUTPUT or a user-specified file. The dump is four words per line. If lines are duplicated, 
they are suppressed and an informative message is issued to the output file. 


NOTE I 

The DMPECS command can dump only up to two 
million words of extended memory. If you 
want to dump more than two million words, 
use the DMB command (described in this 
section). 


A DMPECS command within an interactive job copies the contents of the extended memory of the 
job's field length to the local file ZZZDUMP and displays a message at the terminal 
informing you of the dump. ZZZDUMP is not rewound before or after the dump. 

Formats; 


DMPECS,fwa,Iwa. 
DMPECS,Iwa. 

DMPECS,fwa,Iwa,f,Ifn. 


Parameter 


fwa 


Iwa 


Description 


Specifies the first word address of extended memory to be dumped; fwa 
is relative to the reference address of the field in extended memory 
being used by the job (RAE). 

Specifies the last word of extended memory to be dumped; Iwa is 
relative to RAE. 


f Specifies the print format (included for compatibility with NOS/BE). 

Ifn Specifies the file to dump to. 


If the first format is used, the field in extended memory defined by fwa and Iwa is dumped 
to the file OUTPUT. Display code equivalences do not appear. 

If the second format is used, DMPECS assumes fwa is 0. Display code equivalences do not 
appear. 


If the third format is used, the specified field in extended memory is dumped to Ifn, The 
parameter f is ignored. Display code equivalences appear to the right of the octal 
representations, the same as the DMDECS command. 


The DMPECS command must immediately follow a program to be dumped, except that another 
DMDECS or DMPECS, DMB, DMP, DMD, or EXIT command may intervene. 

Dumping always stops at the field length in extended memory (FLE) if Iwa is greater than FLE. 

If fwa is greater than FLE, fwa is set to FLE-10. If both fwa and Iwa are greater than FLE, 
fwa is set to FLE-10 and Iwa is set to FLE. 
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LBC COMMAND 

The LBC command Is Intended for loading binary data of unknown format* 

Format: 

LBC,addr. 

Parameter Description 

addr Specifies the address relative to RA at which binary load begins; if addr 

is omitted, 0 (RA) is assumed. 

LBC reads only one record from file INPUT. You must make an LBC call for each record of 
data to be loaded. If addr is specified in the program call, binary data is loaded 
beginning at that address; otherwise, loading begins at the reference address (RA). 

LOG COMMAND 

The LOC command reads octal line Images from file INPUT and enters them in the job's central 
memory field length. 

Format s: 

LOC,fwa,Iwa. 

LOC,lwa. 

LOC. 

Parameter Description 

fwa Specifies the first word address of an area to clear (zero) before loading 

correction statements. If fwa is absent, LOC assumes 0. 

Iwa Specifies the last word address plus 1 of the area to be cleared. If Iwa 

is absent, LOC assumes 0. 

To process the LOC command, the system reads correction statement Images from the current 
INPUT record. A correction statement consists of an octal address and a data field. The 
address field specifies the location to be corrected, and the data field contains the data 
to be placed in that location. Both fields may start at any colimin as long as the address 
precedes the data. The address field consists of a one- to six-digit address. If it is 
five characters or less, it is separated from the data field by a nonoctal character (for 
example, a blank). If it is six characters, no separator is required. 

The data field consists of 1 to 20 octal characters. If it is less than 20 characters, it 
is terminated by a nonblank, nonoctal character and is stored right-justified. If it is 20 
characters, no terminator is required. Embedded blanks in the data field are Ignored. 

If both fwa and Iwa are specified and both are nonzero, storage is cleared from fwa to Iwa, 
and the octal line images are loaded at the specified addresses. If the current INPUT 
record is empty, LOC clears the indicated area of memory. 
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PBC COMMAND 

The PBC routine writes one record from the specified area of central memory to file PUNCHB. 


Formats; 


PBC,fwa,lwa. 

PBCjlwa. 

PBC. 


Parameter 


fwa 


Iwa 


Description 


Specifies the address relative to RA, at which the binary deck begins; 
if this parameter is omitted, the PBC operation depends upon the 
presence or absence of Iwa. 

Specifies the last word address of the binary deck. If Iwa alone is 
present, PBC assimes that fwa is RA. If Iwa equals fwa, and a nonzero 
value is specified, PBC adds IO 3 to Iwa. If fwa and Iwa are 0 or 
are omitted, Iwa is set to the value in the lower 18 bits of RA. If 
the upper 12 bits of RA are TIOOg, iwa is the lower 18 bits of the 
location following the prefix (77) table plus the length of the prefix 
table. 


Central memory is not altered by PBC. 


RBR COMMAND 


The RBR command loads one binary record from a specified file. 
Format: 

RBR,n,name. 

Parameter Description 


n Specifies that n is used in constructing the name of the file 

containing the binary record to be read. If n is less than four 
characters and is numeric, TAPEn is the file name. If n contains a 
nonnumeric character or is four or more characters long, n itself is 
used as the file name. If n is absent, TAPE is the file name. 

name Specifies the one- to seven-character name used in a record prefix. 

The RBR command loads one binary record from the specified file into central memory starting 
at RA. If the name parameter is included, a record prefix is placed in central memory 
starting at RA. The record itself follows. The following is the format of the record 
prefix. 
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RA 

RA+1 

RA+2 

RA+3 


RA+17 

RA+208 



length Record length including the prefix. 

length]^ Record length minus words RA through RA + 17g. 


If the record is too long for available memory, memory is filled, excess data is skipped, 
and an error message is Issued to the job's dayfile. 


WBR COMMAND 

The WBR command writes a binary record from central memory to a file at its current position. 

Format; 

WBR,n,rl. 

Parameter Description 

n Specifies the n is used in constructing the name of the file on which the 

binary record is to be written. If n is less than four characters and is 
numeric, TAPEn is the file name. If n contains a nonnumeric character or 
is four or more characters long, n Itself is used as the file name. If n 
is absent, TAPE is the file name. 

rl Specifies the record length in words. If rl is 0 or absent, the length is 

taken from the lower 18 bits of RA. 

WBR begins writing from RA. 
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TAPE MANAGEMENT 


12 


This section describes conmands used with magnetic tape files. For additional information 
on NOS magnetic tape files, consult the glossary for definitions of terms; Magnetic Tape 
Files in section 2 for descriptions of tape labels and data formats; and appendix G for tape 
label formats. Section 7 describes the RESODRC command required in jobs that use more than 
one tape or removable auxiliary pack concurrently. 

To write on unlabeled tapes, you must have special authorization (refer to the LIMITS 
command). 


NOTE 


The term file as used in this section may 
refer to a multifile file. Refer to table 
2-1 for the EOR and EOF marks for tape files. 


The commands described in this section are: 


ASSIGN Assigns a local file to a tape unitt (system origin jobs or jobs with 

system origin privileges only). Section 9 describes the ASSIGN command 
for nontape files. 

BLANK Blank labels a tape and may restrict access to the labeled tape. 

LABEL Assigns a local file to a magnetic tape, creates and verifies tape 

labels, and creates and accesses multifile set tapes. 

LISTLB Lists tape labels. 


REQUEST Assigns a local file to a magnetic tape device. 

VSN Associates a file name with one or more VSNs for later assignment by a 

LABEL or REQUEST command. 


TAPE ASSIGNMENT 

Whenever a tape is mounted, the system checks for labels. If the tape is labeled, the 
system records the volume serial number (VSN) read from the VOLl label and the equipment on 
which the tape is mounted. When a tape assignment is requested by a LABEL or REQUEST 
command specifying an Ifn and a VSN (or an Ifn that has been named in a previous VSN 
command), the system compares the VSN with the VSNs read from mounted tapes. If a match is 
found, the system automatically assigns the tape to the requesting job, provided a deadlock 
would not occur .ft If the tape is not mounted, the system rolls out the job until a tape 
with the requested VSN is mounted. 


tif you do not specify a VSN parameter or an MT or NT parameter on the tape assignment 
command, the operator can assign the file to any device, 
ttkefer to the RESOURC command in section 7. 
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For a mounted, unlabeled tape, the operator enters a command specifying the requested VSN. 
The system can then assign the tape. A VSN which contains nonalphanumeric characters should 
not be specified in a request for an unlabeled tape because nonalphanumeric characters 
cannot be entered with the operator command. 

If a VSN is not associated with the requested Ifn, the system directs the operator to assign 
an available device. 


COMMAND RULES 

On the tape assignment commands (LABEL, REQUEST, and ASSIGN), you can specify the tape label 
contents, tape density, track type, nine-track conversion mode, data format, noise size, and 
processing options. If any of these specifications are omitted, the system uses a default 
value. 


NOTE 


1. For nine-track tapes, the density 
specification given on the tape assignment 
is used only when the tape is written from 
load point. Otherwise, the tape is read or 
written using the density previously used 
for that tape. To ensure that a labeled 
tape is at load point for rewriting the tape 
at a new density, perform one of the 
following before the write operation. 

• Rewind the tape. 

• Specify the W parameter on the LABEL 
command used to assign the tape. 

• Assign the tape using a REQUEST or 
ASSIGN command. 

2. Do not create labeled S or L format tapes 
with tape marks embedded in the data. 

Future adherence to ANSI standards will make 
these tapes nonstandard as the ANSI standard 
allows tape marks to be used only as 
delimiters of label groups. 


Do not specify duplicate or equivalent parameters. When you specify a parameter, do not 
use = as a separator unless the parameter requires the keyword=value format. 
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You can use a continuation line for an ASSIGN, BLANK, LABEL, FiEQUEST, or VSN command when 
any one of these requires more than 80 characters. If, in processing one of these commands, 
the system does not encounter a termination character prior to the end of the line, it 
assumes the next line is a continuation line. A continuation line should be terminated with 
^ terminator. The terminator for a continuation line must appear in or before 

column 80. 


I NOTE ) 


The system accepts continuation lines from an 
interactive terminal only if they are within a 
procedure file. 


You can use literals for parameters that contain nonalphanumeric characters. These 
parameters are FI/L, FA, SI/M, VA, FA, OFA, and VSN. Nonalphanumeric characters are 
characters other than letters, numbers, and asterisks. 

A literal is a character string delimited by dollar signs. Blanks within literals are 
retained. If the literal is to contain a dollar sign, two consecutive dollar signs must be 
included. Thus, the literal 

$A B$$41$ 

is interpreted as 

A B$41 

When continuation lines are used, a literal cannot extend from one line to another. 


PROCESSING OPTIONS 

The P0= parameter on the LABEL, ASSIGN, and REQUEST tape assignment commands specify one or 
more processing options that are to apply to that tape file. The characters representing 
the processing options and their meaning are listed below. 

PO=S gives the default end-of-tape conditions. Default error recovery attempts to recover 
blocks having errors by repeatedly rereading the block. If the A, E, or N processing 
options are not specified, the program determines whether an error aborts the job or the 
program performs error processing (refer to the FET ep bit description in Volume 4, Program 
Interface). 

Description 

A Automatically aborts job on an irrecoverable read or write parity 

error (refer to the N option). 

C Selects write with data compression if a cartridge tape (type CT or 

AT) is being requested. The data compression capability must be 
installed and enabled in the cartridge tape controller. Only data 
blocks are written with compression; tape labels are always written 
without cort^ression so that the labels are recognized on systems that 
do not support data corr^jression. If the data compression capability 
is not installed and enabled, the C option is ignored and data blocks 
are written without compression. 
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Pi 


Description 


E Specifies error inhibit. All hardware read/write errors are ignored 

and processing continues. The system does not attempt error recovery, 
issue error messages, or return error status. During a read 
operation, blocks less than noise size (refer to the NS parameter) are 
unconditionally bypassed. Use this option guardedly. Use it to 
recover portions of data from a bad tape, to check out hardware, and 
to write on tape without skipping bad spots; in the latter case, you 
are responsible for verifying that the data is written correctly. 

F Forces unload. Unload at end of usage. (Refer to the U option.) 

G Disables all hardware error correction activity in GE (6250 cpi) write 

mode. An on-the-fly error while writing a GE tape results in standard 
error recovery processing. The system erases the defective portion of 
tape, thereby reducing the amount of data that can be stored on the 
tape. The default is installation-defined (refer to the H option). 

H Enables hardware error correction activity in GE (6250 cpi) write 

mode. The system allows certain types of single-track errors to be 
written that can be corrected when the tape is read (on-the-fly 
correction). This is the recommended mode because it provides 
efficient throughput, error recovery, and tape usage when writing GE 
tapes on a mediinti that is suitable for use at 3200 fci or 6250 cpi. 

The default option (G or H) is installation-defined. 

I Rewrites the block on which the end-of-tape occurred as the first 

block on the next volume, if the system senses the EOT during a write 
operation. During a read operation, the block on which the EOT 
occurred is ignored and reading continues on the next volume. If a 
tape mark and the EOT are sensed at the same time, the EOT is ignored. 
This option cannot be specified for 7-track I or SI format tapes. 

This option is ignored for CT or AT tapes. Refer to the P and S 
options. 

L Does not issue tape detailed status error messages to the user 

dayfile. The default is installation-defined (refer to the M option). 

M Issues only the first and last tape detailed status error messages to 

the user dayfile for each bad tape block. Numerous attempts are made 
to read each bad block, but only the messages for the first and last 
attempts are issued to the dayfile. The default is installation- 
defined (refer to the L option). 

N Specifies that the job is not automatically aborted on an 

irrecoverable read or write parity error (refer to the A option). 

Data is passed to the job on a read operation without error status set 
even if the program requested error processing. Use this option 
guardedly. 

P Writes a trailer sequence following the block on which the EOT was 

sensed, if the system senses the EOT during a write operation. Any 
data that occurs following the block on which EOT was sensed, yet 
before the tape mark, is ignored. During a read operation, the system 
transfers the block on which the EOT was sensed to the user job. The 
read operation resumes on the next reel. If a tape mark and the EOT 
are sensed at the same time, the EOT is ignored. This option is 
ignored for CT or AT tapes. Refer to the I and S options. 

R Enforces read-only protection. Any attempt to write on the tape is 

rejected. 

S Specifies where the system is to stop on an exit condition. For an 

unlabeled tape, it directs the system to stop at the first tape mark 
after the EOT is sensed. For a labeled tape, it directs the system to 
stop at the tape mark plus EOFl or the tape mark plus EOVl when the 
EOT is encountered. 
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Description 


Pi 


If, during a write operation, the system senses the end-of-tape, the 
system writes a trailer sequence following the block on which the EOT 
was sensed. This trailer sequence consists of a tape mark followed by 
an EOVl label for labeled tapes and four tape marks for unlabeled 
tapes. The next block is written on the next volume. During a read 
operation, the EOT is noted and the system transfers to the user job 
the block on which the EOT was sensed plus all following blocks until 
a trailer sequence (as described previously) is recognized. Reading 
resumes on the next volxime. 

U Inhibits unload. Do not unload at the end of usage. For system 

origin jobs and the RECLAIM command, the inhibit unload option is 
selected by default; for all other jobs, omission of the U option 
causes the tape to be unloaded at end of usage. 

W Enforces ring in. If the tape is mounted without the write ring in 

(for an MT or NT tape) or with the write-enable thumbwheel in the 
wrong position (for a CT tape), job processing is suspended until the 
operator remounts the tape correctly. If an AT tape is mounted with 
the write-enable thumbwheel in the wrong position, the tape is 
unloaded and the job is aborted. 

Specifying QN=9999 on the LABEL command has the same effect for 
multifile tapes. 

X When specified in a system origin job, causes security checks 

pertaining to ANSI label processing to be enforced as if the job were 
not system origin. Specifically, the following policies are enforced: 

Nonexpired files cannot be overwritten. 

A VOLl label cannot be overwritten if the volume accessibility 
field in the label is nonblank. 

The file accessibility field in the HDRl label is checked 
before allowing access to a file. 

If both PO=R and PO=W are specified or more than one EOT option (I, P, or S) is specified, 
the system issues a dayfile message and terminates the job step. 

For further information on end-of-tape and end-of-volume conditions, refer to the CLOSER, 
REWIND, UNLOAD, and LABEL macros in Volume 4, Program Interface. 


ASSIGN COMMAND 

The ASSIGN command names a tape unit and the local file to be assigned to that unit. It can 
create an unlabeled tape file or access an existing labeled or unlabeled tape. It cannot 
create or verify tape labels. 


I NOTE I 


To assign a tape unit using the ASSIGN command, 
your job must be of system origin or you must be 
authorized to use magnetic tapes and to assign 
devices by EST ordinals. An ACS cartridge tape 
unit cannot be assigned with the ASSIGN command. 


Jobs that use this command without proper validation are aborted, and a dayfile message is 
issued. 

Before performing the assignment, the system unloads the local file (refer to the UNLOAD 
command in section 9) . 
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ft^-‘'-'“ "•• “• — 

Format: 


ASSIGN,nn,lfn, (■'^SN-vsni/vang/ ... /vsn^ 1 |D=den| 

|VSN=evsni=ivsni/.../evsnn=ivsnJ / F=format,LB=lb, 



,NS=ns, PO=p 2 ^P 2 .. .pjj. 


3 


,AL=level. 


Description 

?hrEST°LH?n^?t T® assigned, nn can be 

the EST ordinalT of a magnetic tape unit of type dty. Omission of 
this parameter results in an error. 


Ifn 

Optional parameters: 


narLer.r'"^ ^^sig^ed to the device nn. Omission of this 

parameter results in an error. 


Parameter 


VSN=vsni/vsn2/.../vsn^ 
or 

VSN=evsni=ivsni/.../evsnn=ivsnn 


DT=dty 


Description 

One- to six-character volume serial number that 
uniquely identifies a tape volume. If the VSN 
contains nonalphanimieric characters, it must be a 
J-iteral delimited by dollar signs ($). 

^SIGN does not use the VSN parameter to assign the 
first volume of the tape; instead, it uses the nn 
parameter. The VSN parameter is allowed so that you 
may specify the identity of subsequent volumes. 

If multiple VSNs are specified with the VSNs 
separated by the / character, each VSN specifies the 
Identity of one volume of a multivolume set, and the 
volumes are assigned in the order specified. 

For each volume, two VSNs may be specified with the 
VSNs separated by the = character. If this format 
IS used for one volume of a multivolume set, it must 
volumes. The first VSN specifies 
the external" VSN and the second VSN specifies the 
internal" VSN. The internal VSN is the VSN 
recorded in the ANSI VOLl label on the tape. The 
external VSN is the "human-readable" VSN on the 
exterior of the tape. For an AT cartridge tape, the 
external VSN is the machine-readable (bar code) VSN 
on the exterior of the cartridge. 

Tape device type; must not conflict with the D=den 
specification. You can omit this parameter if the 
D-den parameter uniquely identifies the tape type 
(all D-den values except 800 cpi and 38000 cpi) 

The default is installation-defined. 


CT 

MT 

NT 


Meaning 

Cartridge tape for CTS. 
Seven-track tape. 
Nine-track tape. 


tContact installation personnel for a list of EST ordinals. 
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Parameter 


Description 


D=den or den Tape density; must not conflict with the DT=dty 

specification. The default is installation-defined. 
The paurameter is ignored for nine-track tapes not 
positioned at load point. Can be: 


Seven-track (»fr) 

Nine 

-track (NT) 

den 

Densitv 

den 

Densitv 

LO 

200 cpi 

HD 

800 cpi 

HI 

556 cpi 

PE 

1600 cpi 

HY 

800 cpi 

GE 

6250 cpi 

200 

200 cpi 

800 

800 cpi 

556 

556 cpi 

1600 

1600 cpi 

800 

800 cpi 

6250 

6250 cpi 

Cartridge for 



CTS 

(CT) 



den 

Densitv 



CE 

38000 cpi 



38000 

38000 cpi 
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Parameter 


Description 


F=format 


LB=lb 


FC=fcount or C=ccount 


t NOS/BE system default tape 
NOS/BE systems. 


Data format. Default is I. Refer to Magnetic Tape 
Files in section 2 for descriptions of the data 
formats. 

Format Description 

I Internal. 

LI Long block internal. 

SI System internal. 

L Long block strauiger. 

S Stranger. 

F Foreign (designed for tapes of unknovm 

data format) . 

Labeled or unlabeled tape. Default is KO if VSN is 
omitted or KL if VSN is specified. 

lb Meetnina 

KL ANSI-labeled. If the tape is a NOS 

tape, volume cuid header label access 

restrictions are enforced (refer to 
appendix G). 

KCr Dnlabeled. 

NS Nonstandard-labeled. Assumes data 

begins immediately aifter the first tape 
mark. 

Whenever F format is specified, this parameter must 
be specified. It specifies maximum block size in 
freunes. No default value. Illegal for other tape 
formats. 


format (binary mode only) ; used for tape interchange with 


60459680 P 


12-7 



Parameter 


Description 


CV=cv or N=cv 


KS=n8 


P0=PiP2...Pn 


CK or CB 


Conversion mode^ for nine-track tapes (NT) or 
cartridges (CT or AT) ; on coded tapes, applies both 
to labels and to data; on binary tapes, applies only 
to labels. Default is installation-defined. 
Parameter is ignored for unlabeled I, LX, or SI 
format binary tapes whose trailer labels are always 
ASCII. Must not be specified with DT=lir or with any 
seven-track density. 

cv Meaning 

AS ASCII-display code conversion. 

US Same as AS. 


EB EBCDIC-display code conversion. 

Noise size. Any block containing fewer than ns 
frames is considered as noise and is discarded. The 
NS parameter is not valid for I, LI, or SI format 
tapes or for other tape formats when either PE (9- 
track, 1600 cpi), GE (9-track, 6250 cpi), CE 
(cartridge for CTS, 38000 cpi) or AE (cartridge for 
ACS, 38000 cpi) density is specified. For these 
densities, the noise block size is zero. Default is 
18 frcunes for other formats. Maximum value is 31 
frcunes. If NS=0 is specified, the default is used. 


A string of characters (not separated by commas) 
that specify processing options (refer to Processing 
Options in this section). 

Specifies that Ifn is to be used as a checkpoint 
file (refer to section 13). 


CK Each dunp is written at the previous 

EOI of Ifn. 


CB Each duzp is written at the BOX of Ifn. 


t Refer to Magnetic Tape Users in appendix A. 
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Parameter 

AL=level 


Bxaople: 


PeBcription 

Specifies the security access level to assign to the 
file. Unless changed by your site, level can be one 
of the following names: 

LVLO, LVLl, LVL2, LVL3, LVL4, LVL5, LVLG, or LVL7 

The default is the current access level of the job. 

On a secured system, the "access level you specify 
must be valid for the job (ENQUIRE,B returns this 
information) and for the device to which you are 
assigning the file. 

On an unsecured system, the parameter has no effect. 
The system does, however, check for valid parameter 
specifications. 

When using this command to assign a file for 
checkpoint dunps on a secured system, use the 
AL=level parameter to assign the file at the highest 
access level valid for the job (ENQUIRE,B returns 
this information) . The CKP command edsorts the job 
if the checigsoint file is not at this access level. 


ASSIGN,51,TAPE1,D=PE,F=SI. 

This command assigns the file TAPEl to the nine-track magnetic tape unit identified by EST 
ordinal 51. 
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BLANK COMMAND 


The BLANK connnand writes the ANSI standard labels VOLl, HDRl, and EOFl following the load 
point of a tape. The labels are written as follows (asterisks represent tape marks): 


VOLl 

HDRl 

* 

* 

EOFl 

* 

* 






If the value of a labeled field is specified by a BLANK command parameter, that value is 
written; otherwise, the default value is used. Refer to appendix G for the tape label 
formats and default values. 


NOTE 


A BLANK command issued if a nonsystem 
origin job cannot overwrite a label 
containing eui unexpired expiration date or 
a nonblank VA field. 

If the FA field within the label is 
nonblank, a nonsystem origin job must 
specify the FA character using the OFA 
pcurameter. If the FA character is A, only 
the owner or a system origin job can 
overwrite the label. 


Format: 


BLANK, VSN=vsn,EVSN=evsn,DT=dty,|°=^®"|,|^“^J,FA=fa,OFA=ofa,VA=va, 

OWNER=UBemame/f eunilyname, LSL=lsl, U. 

Description 

VSNsvsn One- to six-character volume serial number that 

viniguely identifies the reel of tape. It is entered 
in the VOLl label. It need not match the VSN 
previously recorded on the tape. 


NOTE 


Avoid specifying a volume serial 
number that matches a local file 
name attached to your job or the 
local file will be lost. 

Omitting the VSN parameter 
discards any local file named 
BLKTAFE from your job. 
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Paxameter 


Description 


EVSN=evsn 


DT=dty 


One- to six-character external volume serial nxamber 
that uniquely identifies the tape. For an AT 
®®J^tridge tape, this is a required paurameter; it 
specifies the machine-readable (bar code) VSN on the 
exterior of the cartridge. For all other types of 
tape, this parameter is not allowed. The value 
specified for even need not match the value 
specified for vsn. 

Tape device type; must not conflict with the D=den 
specification. You can ewiit this parameter if the 
D=den parameter uniquely identifies the tape type 
(all D=den values except 800 cpi and 38000 cpi) . 

The default is installation-defined. 


dtv Meamino 

ITT Seven-track tape. 

NT Nine-track tape. 

AT Cartridge tape for ACS. 

CT Cartridge tape for CTS. 


D=den or den 


Tape density; must not conflict with the DT=dty 
specification. The default is installation-defined, 
den can be one of the following: 


Seven-track (MT> 

den Density 

1*0 200 cpi 

HI 556 cpi 

HY 800 cpi 

200 200 cpi 

556 556 cpi 

800 800 cpi 

Cartridge for 
ACS (AT) 

den Density 

AE 38000 cpi 

38000 38000 cpi 


Nine 

-track (NTl 

den 

Densitv 

HD 

800 cpi 

PE 

1600 qpi 

GE 

6250 cpi 

800 

800 cpi 

1600 

1600 cpi 

6250 

6250 cpi 


Cartridge for 
CTS (CT) 


den Density 

CE 38000 cpi 

38000 38000 cpi 
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Parameter 


Description 


CV=cv or N=cv Conversion modet for nine-trade (NT) or cairtridge 

(err or AT) t^e labels. Installation-defined 
default. Must not be specified with DT=Iir or with 
any seven-track density. 

cv Meaning 

AS ASCII/G-bit display code conversion. 

ns Same as AS. 

EB EBCDIC/S-bit display code conversion. 

FA=fa File accessibility character indicating who has 

access to the ladseled tape. Value entered in HDRl 
and EOFl labels. 

fa Description 

Blank Unlimited access (default). 

A Only the owner of this NOS written tape 

can access it. 

Other In all future accesses of this tape, 

you must specify this character. 

OFA=ofa Old file accessibility character on a labeled tape 

that is to be relabeled. This parameter must be 
specified if the FA field is currently other than A 
or blank. Future accesses of the tape must specify 
the character specified with the FA parameter. 

Volume accessibility character indicating that the 
volume must be accessed as ah ANSI-labeled tape 
(IjBs:KL) . If VA is nonblank, only a system origin 
job can destroy VOLl (for exanple, assign tape as 
unlabeled). Default is unrestricted access. Refer 
to the VDLl format in appendix G. 

OWNER=usemame/familyname Owner identification entered in VOLl label. 

Determines the owner for file accessibility (FA) 
parameter. 


t Refer to Magnetic Tape Users in appendix A. 


60459680 F 


12 - 10.1 



Parcuneter 


Description 


LSL^lsl 


Label standard level entered in VOLl label. Default 
is the number 1. 


Isl Description 

1 Tape labels and data format for this 

volume conform to the ANSI standard. 

Blank Tape labels and data format for this 
volume may or may not conform to the 
ANSI standard. 

U If U is specified, the tape is physically imloaded 

when returned after blank labeling. If U is 
canitted, physical unloading is inhibited. 

An installation can use the BLANK command to restrict use of its labeled tapes. Once a tape 
has been blank labeled, you can modify the labels as follows: 

1. If the volim\e accessibility field of VOLl indicates unlimited access (that is, VA is 
blank), you can: 


• Include another BLANK command to change VOLl, HDRl, or EOFl values. 

• Request the tape as unlabeled (with the parameter LB=Ka) and write it in 
whatever format you specify. 

• Include a liABEL command to change HDRl by specifying one or more of the 
parameters associated with that label and specifying the W parameter. 

2. If the volume accessibility field is nonblank, you can: 

• Include a LABEL command to change HDRl. However, in requesting a tape in 
which VA is nonblank, you must specify an ANSI-labeled tape (with the 
parameter LB=KL), and therefore, cannot change or destroy the VOLl label. 

• If validated, submit a system origin job to change VOLl. 
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LABEL COMMAND 


Like ASSIGN and REQUEST commands, the LABEL command associates a file name Ifn with a 
magnetic tape, usually identified by its VSN. Unlike the ASSIGN and REQUEST commands, the 
LABEL command can create and verify tape labels. It can also position a multifile set for 
access to any of its existing files or for appending a new file. The LABEL command can 
create and access unlabeled as well as labeled tapes. 


I NOTE I 


A LABEL command cannot overwrite a label 
with an unexpired expiration date (refer 
to appendix G). 


To write the labels that begin a labeled tape (refer to Magnetic Tape Files in section 2), 
specify a write label (W) parameter. The W parameter always rewinds the tape to load point 
and rewrites the first label group. Overwriting the header labels for a tape file 
effectively destroys the data on the file. The label contents remain the same when a LABEL 
command with the W parameter names an Ifn already assigned to a tape file. 

If the tape was not previously part of a multifile set (the SI field in the first HDRl label 
is blank), then specification of the SI and QN=9999 parameters rewrites the initial tape 
labels. 

To position the tape after any HDRl label other than the first HDRl label (multifile set 
only), the SI parameter must be specified. When SI is specified, the R and W parameters are 
ignored unless QN—1 and the first file on the tape is to be written. The system determines 
where to position the tape by matching the SI, FI, and QN parameter values (if specified) to 
the corresponding values in the HDRl label. (The HDRl label format is given in appendix G.) 

To write the EOFl and HDRl labels between two files in a multifile set (refer to figure 2- 
2), you specify the SI and QN=9999 parameters. The W parameter is ignored if specified when 
appending the file (QN=9999). Although the SI=setid parameter must be specified when 
appending a file to a multifile set, the appended file will be given the same setid as the 
preceding file regardless of the setid value specified in the LABEL command. This is done 
to ensure that all files in a file set have the same set identifier. 

If neither the MT, NT, nor DT parameter is specified and no VSN is named, the operator can 
assign the file to a non—tape equipment. You must be validated for the assigned equipment 
or the job is terminated. 
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Format: 


LABEL 


,nn,lfn, jvSN=vsni/vsn 2 /.../vsn^ 

jVSN=evsn]^=ivsnj^/. . ./evsnjj=ivsnjj 

FC=fcountl )cv=cv| (ck| 

I'I N=cv|' ^1^2’■‘^n'l Cb| 'I M=setid|' 

(QN=seqnol 


DT=dty,D=den,F=format,LB=lb, 
SI=setidl 


I SN=secno] 
I V=secno j 
|cR=cdate| 
1 C=cdate| 


|P=seqno j 

RT=yyddd 

T=ddd 


FI=fileid ^ ' 

' L=fileid ' 


I'l- 


,AL=level, 


AC=ac,CT=ct,KD=md,PW=password,TO=to,UN=username. 
Required parameter: 

Parameter 


Description 


Ifn Name of the file that resides or is to reside on 

magnetic tape. If Ifn is already assigned to a mass 
storage file, processing continues with the next 
command. To assign a previously assigned Ifn, you 
must return Ifn before its reassignment. If Ifn is 
ali:eady assigned to a tape and R parameter is 
specified, the contents of the tape labels are 
compared to the command parameter specifications. 

If the label verification fails, the job aborts. 
Omission of Ifn results in an error. 


Optional parameters: 

Parameter 


Description 


VSN=vsn]^/vsn 2 /. . ./vsn^j One- to six-character volume serial number that 

uniquely identifies a tape volume. If the VSN 
VSN=evsni=ivsni/.../evsnj,=ivsnji contains nonalphanumeric characters, it must be a 

literal delimited by dollar signs ($). You should 
specify a VSN for both labeled and unlabeled tapes. 
If the VSN parameter is omitted, the operator must 
assign an available unit. 


If VSN=, VSN=0, or VSN=SCRATCH is specified, a 
scratch tape is assigned. If a scratch tape is 
unavailable, the job is suspended until a tape is 
available. 


If multiple VSNs are specified with the VSNs 
separated by the / character, each VSN specifies the 
identity of one volume of a multivolume set, and the 
volumes are assigned in the order specified. 

For each volume, two VSNs may be specified with the 
VSNs separated by the = character. If this format 
is used for one volume of a multivolume set, it must 
be used for all volumes. The first VSN specifies 
the "external" VSN and the second VSN specifies the 
"internal" VSN. The internal VSN is the VSN 
recorded in the ANSI VOLl label on the tape. The 
external VSN is the "human-readable" VSN on the 
exterior of the tape. For an AT cartridge tape, the 
external VSN is the machine-readable (bar code) VSN 
on the exterior of the cartridge. 


12-12 


60459680 R 



Parameter 


Description 


DT=dty 


D=den or den 


F=format 


t NOS/BE system default 
NOS/BE systems. 


Tape device type; must not conflict with the D=den 
specification. You can emit this parameter if the 
Dsden parameter uniquely identifies the tape type 
(all D=den values except 800 cpi and 38000 cpi). 
The default is installation-defined. 


dtv 

Heanina 


AT 

Cartridge tape for 

ACS 

CT 

Cartridge tape for 

CTS 

MT 

Seven-track tape. 


NT 

Nine-track tape. 



Tape density; must not conflict with the DT=dty 
specification. The default is installation-defined. 
The parameter is ignored for nine-track tapes not 
positioned at load point. Can be: 


Seven-track (MT) 

Nine 

-track (NT) 

den 

Densitv 

den 

Densitv 

LO 

200 cpi 

HD 

800 cpi 

HI 

556 cpi 

PE 

1600 cpi 

HY 

800 cpi 

GE 

6250 cpi 

200 

200 cpi 

800 

800 cpi 

556 

556 cpi 

1600 

1600 cpi 

800 

800 cpi 

6250 

6250 cpi 

Cartridge for 

Cartridge for 

ACS 

(AT) 

_<3S (CT) 

den 

Densitv 

den 

Dgqpity 

AE 

38000 cpi 

CE 

38000 cpi 

38000 

38000 cpi 

38000 

38000 cpi 


Data format. Default is I. Refer to Magnetic Tape 
Files in section 2 for descriptions of the data 
formats. 

format Description 

I Internal. 

LI Long block internal. 

SI System internal.t 

S Stranger. 

L Long block streuiger. 

F Foreign (designed for tapes of unknown 

data format]. 


tape format (binary mode only) ; used for tape interchange with 
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Parameter 


Descrintion 


LB=lb 


FC=fcount 


CV=cv or N=cv 


HS=ns 


Labeled or unlabeled tape. Default is KL. 

lb Description 

KL ANSI-labeled. 

KD Dnlabeled. 

NS Nonstandard-labeled. Assumes data 

begins immediately after the first tape 
mark. 

Whenever F format is specified, this parameter must 
be specified. It specifies the maximum block size 
in frames (no default value). Not applicable for 
other tape formats. 

Conversion mode ^ for nine-track tapes (NT) or 
cartridges (CT or AT); on coded tapes, applies to 
both labels and data; on binary tapes, applies only 
to labels. Installation-defined default. Ignored 
for unlabeled I, LI, or SI format binary tapes whose 
trailer labels are always ASCII. Must not be 
specified with DT=lfr or with any seven-track 
density. 

cy Meaning 

AS ASCII/display code conversion. 

US Same as AS. 

EB EBCDIC/display code conversion. 

Noise size; euiy block containing fewer than ns 
frames is considered noise and is discarded. The NS 
parameter is not valid for 1, LI, or SI format tapes 
or for other tape formats when AE (caxtridge for 
ACS, 38000 cpi), CE (cartridge for CTS, 38000 cpi), 
PE (9-track, 1600 cpi) or GE (9-track, 6250 cpi) 
density is specified. For these densities, the 
noise block size is zero. Default is 18 frames for 
other formats. Maximum value is 31 frames. If NS^O 
is specified, the default is used. 


t Refer to Magnetic Tape Users in appendix A. 
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Parameter 

P0=PiP2...Pn 


CK or CB 


Description 

A string of characters (not separated by commas) 
that specifies processing ppticais. Refer to 
Processing Options in this section. 

Specifies that Ifn is to be used as a checkpoint 
file (refer to section 13). 

CK Each dimp is written at the previous 

BOI of Ifn. ' 

CB Each duap is written at the BOI of Ifn. 
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Optional tape label parameters (refer to appendix G): 

Parameter Description 

SI=setid or M=setid One- to six-character file set identifier; must be 

specified for file positioning within a multifile 
set. 

The system leaves the set identifier field in the 
HDRl label blank if you omit the SI=setid parameter 
or if you specify blanks for setid. 

You must specify a nonblank file set identifier to 
build a multifile set. Hence, if you omit this 
parameter when you write the first file on the tape, 
the tape cannot then be a multifile set tape. When 
you append a file to a multifile set tape, you must 
specify this parameter to position the tape. Also, 
the specified set identifier must be the same as 
that of the first file in the multifile set. 

SN=secno or V=secno One— to four—digit file section number specifying 

the position of the volume within a multivolume file 
set (numbered consecutively from 0001). The default 
is 1. 

QN=seqno or P=seqno One- to four-digit file sequence number specifying 

the position of the file within the multifile set 
(numbered consecutively from 0001). The default is 
1. QN must be set to 9999 to append a new file to a 
multifile set. 

or L=fileld A 1- to 17-character file identifier recorded in the 

HDRl label (refer to appendix G). The default is 
blank. 

File accessibility character indicating who has 
access to the labeled tape. 

fa Description 

Blank Unlimited access (default). 

A Only the owner of the tape can access 

it. 

Other To access the tape, you must specify 
the character in the FA field of the 
HDRl label. 

G=genno One- to four-digit generation number. The number 

zero cannot be used. The default is 1. 
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Parameter 


Description 


E=gvn 

CR=cdate 

RT=yyddd 

R or W 


AL=level 


One- to two-digit generation version number. The 
default is 0. 

or C=cdate Creation date in the form yyddd where 

1 ^ ddd 366. Used only on read operations; write 
operations always use the current date. 

or T=ddd RT=yyddd specifies the expiration date where yy is 

the last two digits of the year, and ddd is the day 
of the year (1 ddd ^ 366). T=ddd specifies the 
number of days the file is to be retained 
(0 ^ ddd ^ 999). The expiration date is entered in 
the HDRl label. On or after this date the label and 
the file can be overwritten. 

If R is specified, the system compares the values 
recorded on the file labels with the LABEL command 
parameter values. If the comparison falls, it 
terminates the job. R is the default. 

If W is specified, the system writes ANSI standard 
labels on the tape. The labels contain the values 
specified with the LABEL command parameters or their 
default values. If the tape is mounted without the 
write ring, job processing is suspended until the 
operator remounts the tape correctly. If both the W 
and the P0=R parameters are specified, the job step 
aborts. 

W and R are ignored when SI is specified and 
QN > 1. When QN = 1 (default value) and W are 
specified, the initial header label is rewritten. 

Specifies the security access level to assign to the 
file. Unless changed by your site, level can be one 
of the following names; 

LVLO, LVLl, LVL2, LVL3, LVL4, LVL5, LVL6, or LVL7 

The default is the current access level of the job. 

On a secured system, the access level you specify 
must be valid for the job (ENQUIRE,B returns this 
information) and for the device to which you are 
assigning the file. 

On an unsecured system, the parameter has no 
effect. The system does, however, check for valid 
parameter specifications. 

When using this command to assign a file for 
checkpoint dumps on a secured system, use the 
AL=level parameter to assign the file at the highest 
access level valid for the job (ENQUIRE,B returns 
this information). The CKP command aborts the job 
if the checkpoint file is not at this access level. 
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Parameter 


Description 


AC=ac 


CT=ct 


MD=md 


PW=password 


TO=to 


UN=username 


Alternate auditability. Refer to the NOS 2 Tape 
Management System (TMS) User Reference Manual for a 
detailed description. 

File category. Refer to the NOS 2 Tape Management 
System (TMS) User Reference Manual for a detailed 
description. 

File Mode. Refer to the NOS 2 Tape Management 
System (TMS) User Reference Manual for a detailed 
description. 

Password. Refer to the NOS 2 Tape Management System 
(TMS) User Reference Manual for a detailed 
description. 

TMS tape option. Refer to the NOS 2 Tape Management 
System (TMS) User Reference Manual for a detailed 
description. 

User name. Refer to the NOS 2 Tape Management 
System (TMS) User Reference Manual for a detailed 
description. 
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Exan?>le 1 - Reading and Writing a Single-File File Set: 

In the following job, the user reads data from one tape and writes data on another tape. 
Program input data previously written at 1600 cpi on a nine-track tape unit is read from 
tape TPOl. Output data is written on tape TP02. 

FTNJOB. 

IISER,USERNAM,PASSWRD. 

RES0URC,PE=2. 

FTN5. 

UBEL,TAPE1,VSN=TP01 ,D=PE,P0=R. 

LABEL,TAPE2,VSN=TP02,D=PE,P0=W,W. 

LGO. 

-EOR- 

PROGRAM SORT 


END 

-E(»- 

The RESOURC command schedules two nine-track, 1600-cpi tape units for concurrent use in the 
job. The tapes are not requested until after compilation of the program in case compilation 
errors occur. 

Assuming the compilation completes without fatal error, the LABEL commands request that two 
tapes, TPOl and TP02, be mounted and assigned to the job. The tape files are called TAPEl 
and TAPE2 within this job. P0=R is specified for the input tape, ensuring that the tape 
does not have a write ring. P0=W is specified for the output tape which requires a write 
The W parameter on the second LABEL command specifies the writing of ANSI standard 
labels. Default values are used in the label fields. 

Following completion of the job, the tapes are rewound and unloaded. 


Example 2 - Reading and Writing a Multifile Set: 

The following job writes the object programs produced by three coii 5 >ilations as three files 
of a multifile set. It then copies one of the files to mass storage and executes it. 

SJOB. 

USER,USERNAM,PASSWRD. 

GET,BSORT,QSORT, LSORT. 

LAB EL, STAPE, VSN=TP03 , D=4’E, SI=8 INSET, FI=B SORT, P0=W,W . 

FTN5,I=BS(»T,B=STAPE. 

UBEL,STAPE, VSN=iTP03, D=PE, S 1=8INSET, FI =QS0RT, W =^999. 

FTN 5,1=CIS OR T,B =S TA PE. 

LABEL, STAPE,VSN=TP03,D=PE,SI=BINSET,FI=LS0RT,ON=9999. 

FTN5,I=LS0RT,B=STAPE. 

UBEL, STAPE, VSN=TP03 , D=PE, SI^ INS ET, QN=2 . 

COP YE I,STA PE, US ORTB. 

QSORTB. 
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The GET command retrieves three indirect access files - BSORT, QSORT, and LSORT - containing 
FORTRAN source programs. The first LABEL command requests the mounting and assignment of 
tape TP03 to the job. The W parameter specifies the writing of ANSI standard labels. The 
set identifier and file identifier fields are written using the valties specified on the SI 
and FI parameters. The B=STAPE parameter on the FTN5 command specifies that the object 
program is to be written on the tape file. 

The QN=9999 parameter on the second and third LABEL commands specifies that a file is to be 
appended to the tape. Although the same set identifier is used for all files within a file 
set, the SI parameter must be specified when positioning a multifile set. Ihe second and 
third compilations write the second and third files of the file set. 

The QN=2 parameter on the fourth LABEL command positions the tape at the second file of the 
file set. The tape could also have been positioned according to the file identifier 
(FI=QSORT). The second file is copied to a local mass storage file, QSORTB, and executed. 


Example 3 - Replacing a File within a Multifile Set: 

To replace a file within a multifile set, you must first copy to temporary storage the files 
that follow the file to be replaced, then write the replacement file, and last rewrite the 
succeeding files in the file set. 

RWJOB. 

USER,USRNAME,PASWRO. 

GET,S0RT2. 

LABEL,STAPE,VSN=TP03,D=PE,SI=BINSET,QN=2,P0=W. 

COPYEI^STAPE,SCRATCH. 

LABEL,STAPE,VSN=TP03,D=PE,SI=BINSET,QN=1. 

C0PYEI,S0RT2,STAPE. 

LABEL,STAPE,VSN=TPQ3,0=PE,SI=BINSET,FI=QSORT,QN=9999. 

COPYEI,SCRATCH,STAPE. 

The first LABEL command requests tape TP03 containing the multifile set created in example 
2. The tape is mounted with a write ring inserted (PO=W) and is positioned at the second 
file of the file set (QN=2). The COPYEI command copies the second file to the mass storage 
file, SCRATCH. 

The second LABEL command positions the tape at the first file. Although the contents of the 
first file are rewritten, the file labels remain unaltered. 

The third LABEL command appends the second file to the file set (QN=9999). The labels are 
rewritten so you can change the label contents. The third COPYEI command writes the second 
file as stored on file SCRATCH. 

The third file of the multifile set is lost, because it was not saved before the tape was 
rewritten. 
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USTLB COMMAND 


The LTSTLB command lists the labels of an ANSI—labeled tape file. For a correct listing of 
labels, the data format specified on the tape assignment command must correspond to the 
format in which the tape was written. For output listing files not connected to your 
terminal, the LISTLIB co mma nd honors the page length and print density set for your job 
using the SET co mma nd and the PL and PD symbolic names. 

Format; 


LISTLB,lfn, 


SI=setid 
M=setid ’ 


QN=seqno 
P=seqno ’ 


LO=ltype,L=out. 


Parameter Description 

File name assigned to tape file whose labels are to 
be listed. Default is file name TAPE. If you use 
the default name, assign TAPE to the labeled tape 
being read. 


SI=setid or M-setid One- to six-character file set identifier. If 

specified, only label groups whose HDRl label 
contains this value are listed. You must specify 
this parameter to list the labels of a multifile set. 

QN—seqno or P—seqno One— to four—digit file sequence number. If seqno 

is specified, only the label group whose HDRl label 
contains this value is listed. If seqno is 
specified, SI must be specified; otherwise, LISTLB 
terminates. 


LO'ltype Label type(s) to be listed. The default is R. 

Required and optional labels are listed in appendix 
G. Combinations of Itype mnemonics can be 
specified, such as LO=VH to list only the VOLn and 
HDRn labels. 

A List all labels. 

R List required labels. 

0 List optional labels. 

V List VOLn labels. 

H List HDRn labels. 

F List EOFn labels. 

E List EOVn labels. 

U List UVLn, UHLn, and UTLn labels. 

File on which the labels are to be listed. Default 
is OUTPUT. 


60459680 H 


12-19 



To list labels for a multifile set (Ifn contains more than one HDRl/EOFl label pair), you 
must specify the Sl=setid parameter and the tape must be positioned to the first file of the 
first set. LISTLB then positions the tape for reading the requested labels. It searches 
for labels through all volumes associated with Ifn. At the end of the multifile set or if 
an expected label group is not found, the following dayfile message is issued, n is the 
sequence number of the last file found, (nnn should be Ignored.) 

MULTI-FILE NOT FOUND, Ifn AT nnn. 

REQUEST SECTION n+1. 

FOUND SECTION n. 

After issuing this dayfile message, LISTLB leaves the tape positioned after the last listed 
label. The next command processed for the tape file must be either RETURN, EVICT, UNLOAD, 
or LABEL. 

For a tape file that is not a multifile set, there are two cases. If you specify trailer 
labels, LISTLB leaves the tape positioned before the trailer labels last listed. Otherwise, 
LISTLB leaves the tape positioned after the label last listed. 


Example 1: 

The following commands list the second label group of file set ABCDEF. 

LABEL, T, VSN=EXAMP 1 ,MT, D=HY, SI=ABCDEF. 

LISTLB,T,SI=ABCDEF,QN=2. 


Example 2: 


To list only the volume and header labels (trailer labels omitted) of a multivolume file 
set, you must request a volume of the file set, list its labels, and return the file set, 
repeating the procedure for each volume of the file set. 


LABEL, T, VSN=REEL 1 ,MT, D=HY. 
LISTLB,T,LO=VH. 

RETURN,!. 

LABEL, T, MT, D=HY, VSN=REEL 2. 
LISTLB,T,LO=VH. 


Example 3: 

To list all labels of the following file set, only one LISTLB command is required. 

VSN,T=REEL1/REEL2. 

LABEL,T,VSN=REEL1,D=HY. 

LISTLB,T. 

The LISTLB(T) command lists all labels on the volumes associated with T, that is, REELl and 
REEL2. 
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REQUEST COMMAND 


The REQUEST command associates a file name, Ifn, with a magnetic tape deviceYou can 
direct the operator to make the tape assignment by including a comment following the command 
terminator. This comment appears at the system console. However, if the tape is labeled 
and you previously specified a VSN via the VSN control command or included the VSN parameter 
on the REQUEST command, the system can automatically assign the tape. The REQUEST command 
can create unlabeled tape files and access existing labeled and unlabeled tape files. It 
cannot create or verify tape labels. 


The LABEL command performs the same function as the REQUEST command. Unless you have reason 
to do otherwise, use the LABEL command. TMS does not support the REQUEST command. 

Format: 


REQUEST,LFN, 

IFC=fcount 


VSN=vsni/vsno/ — /vsn„ I I D=;den 

^ ^ U } DT=dty, I 

VSN=evsn]^=ivsn]^/. . . /evsnjj=ivsnjjj | 


LB=lb, 


CV=cvl 


C=ccount 


I '|N=cv 


,NS=ns,PO=p p 


Required parameter: 

Parameter 

Ifn 


1^2 


, F=format, 

,AL=level.comment 


Description 

Name of the file that resides or is to reside on 
magnetic tape. If Ifn is already assigned to a mass 
storage file, processing continues with the next 
command. To assign a previously assigned Ifn, you 
must return Ifn before its reassignment. Omission 
of this parameter results in an error. 


Optional parameters: 


Parameter 


VSN=vsn2^/vsn2/. . . /vsnj^ 
or 

VSN=evsni=ivsni/.../evsnn=ivsnjj 


Description 

One- to six-character volume serial number that 
uniquely identifies a tape volume. If the VSN 
contains nonalphanumeric characters, it must be a 
literal delimited by dollar signs ($). You should 
specify a VSN for both labeled and unlabeled tapes. 
If the VSN parameter is omitted, the operator must 
assign an available unit. 

If VSN=, VSN=0, or VSN=SCRATCH is specified, a 
scratch tape is assigned. If a scratch tape is 
unavailable, the job is suspended until a tape is 
available. 


If multiple VSNs are specified with the VSNs 
separated by the / character, each VSN specifies the 
identity of one volume of a multivolume set, and the 
volumes are assigned in the order specified. 


I If you do not specify a VSN parameter or a DT parameter on the command, the operator can 
assign any device to the file. If you are not authorized to use the assigned device, the 
job aborts. 
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Parameter 


Description 


For each volume, two VSNs may be specified with the 
VSNs separated by the = character. If this format 
is used for one volume of a multivolume set, it must 
be used for all volumes. The first VSN specifies 
the "external" VSN and the second VSN specifies the 
"internal" VSN. The internal VSN is the VSN 
recorded in the ANSI VOLl label on the tape. The 
external VSN is the "human-readable" VSN on the 
exterior of the tape. For an AT cartridge tape, the 
external VSN is the machine-readable (bar code) VSN 
on the exterior of the cartridge. 

DT=dty Tape device type; must not conflict with the D=den 

specification. The default is installation-defined. 


dty Meaning 

AT Cartridge tape for ACS. 

CT Cartridge tape for CTS. 

MT Seven-traclc tape. 

NT Nine-track tape. 


D=den or den Tape density; must not conflict with the DT=dty 

specification. You can omit this parameter if the 
D=den parameter uniquely identifies the tape type 
(all D=den values except 800 cpi and 38000 cpi). 

The default is installation-defined. The parameter 
is ignored for nine-track tapes not positioned at 
load point. Can be: 


Seven-track (MT) Nine-track (NT) 


den 

Density 

den 

Density 

LO 

200 cpi 

HD 

800 cpi 

HI 

556 cpi 

PE 

1600 cpi 

HY 

800 cpi 

GE 

6250 cpi 

200 

200 cpi 

800 

800 cpi 

556 

556 cpi 

1600 

1600 cpi 

800 

800 cpi 

6250 

6250 cpi 

Cartridge for 

Cartridge for 

ACS 

(AT) 


CTS (CT) 

den 

Density 

den 

Density 

AE 

38000 cpi 

CE 

38000 cpi 

38000 

38000 cpi 

38000 

38000 cpi 
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Parameter 


Description 


F=format 


Data format. Default is I. Refer to Magnetic Tape 
Files in section 2 for descriptions of the data 
formats. 

format Description 

F Foreign (designed for tapes of unknown 

data format). 

I Internal. 

LI Long block internal. 

L Long block stranger. 

SI System internal.t 

S Stranger. 


f NOS/BE system default tape format (binary mode only); used for tape interchange with 
NOS/BE systems. 
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Parameter 


Description 


DBslb 


FC=fcount or C=ccount 


CV=cv or N=cv 


NS=ns 


P0=PiP2...Pn 


Labeled or unlcdjeled tape. Default is KL if a 
voliane serial number is specified by the VSN 
parameter or by a VSN command; otherwise, the 
default is KD. 


lb Description 

KL ANSI-labeled. 

KD Dnlcdseled. 

NS Nonstandard-lcdseled. Assumes that data 

begins immediately after the first tape 
mark. 


Whenever F format is specified, this parameter must 
be specified. It specifies the maximum block size 
in frames (no default value). Illegal for other 
tape formats. 

Conversion mode^ for nine-track (NT) or cartridges 
(CT or AT); on coded tapes, applies to both labels 
and data; on binary tapes, applies only to labels. 
Installation-defined default. Ignored for unlabeled 
I, LI, or SI format binary tapes whose trailer 
labels are always ASCII. Must not be specified with 
MT or with any seven-track density. 


Sy Meaning 

AS ASCII/display code conversion. 

nS Same as AS. 


EB EBCDIC/display code conversion. 

Noise size. Any block containing fewer than ns 
frames is considered as noise and is discarded. The 
NS parameter is not valid for I, LI, or SI format 
tapes or for other tape formats when AE (cartridge 
for ACS, 38000 cpi), CE (cartridge for CTS, 38000 
cpi), PE (9-track, IGOO cpi), or GE (9-track, 6250 
cpi) density is specified. For these densities, the 
noise block size is zero. Default is 18 frames for 
other formats. Maximum value is 31 frames. If NSsO 
is specified, the default is used. 


A string of characters (not separated by ccrnsnas) 
that specifies processing options. (Refer to 
Processing Options in this section.) 


t Refer to Magnetic Tape Users in appendix A. 
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Parameter 


Description 


CK or CB 


AL=level 


comment 


File Ifn is to be used as a checkpoint file (refer 
to section 9). 

CK Each dun^ is written at the previous 

EOI of Ifn. 

CB Each dump is written at the BOI of Ifn. 

Specifies the security access level to assign to the 
file. Unless changed by your site, level can be one 
of the following names: 

LVLO, LVLl, LVL2, LVL3, LVL4, I.VL5, LVL6, or I.VL7 

The default is the current access level of the job. 

On a secured system, the access level you specify 
must be valid for the job (ENQUIRE,B returns this 
information) and for the device to which you are 
assigning the file. 

On an msecured system, the parameter has no effect. 
The system does, however, check for valid parameter 
specifications. 

When using this command to assign a file for 
checkpoint dumps on a secnured system, use the 
AL=level parameter to assign the file at the highest 
access level valid for the job (ENQUIRE,B returns 
this information) . The CKP command aborts the job 
if the checkpoint file is not at this access level. 

The comment appears at the system console. In the 
comment field, you can direct the operator to make 
the requested assignment. 


Excurple: 

To send a message to the operator requesting that volume XYZ be moimted on tape unit NT62 
and assigned to Ifn TAPEl, you could issue the following command. 

REQUEST, TAPEl. NEED VSN=XYZ ON NT062. 
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VSN COMMAND 


The VSN command associates a file name Ifn with one or more volumes of tape.t An Ifn/VSN 
association allows the system to assign the specified VSN to Ifn without reference to a VSN 
parameter on the LABEL or REQUEST command or to an operator command. Once declared, an 
Ifn/VSN association remains until the file is returned by an operation such as an EVICT, 
RETURN, or UNLOAD command. 

Format: 

VSN,lfn =vsn ,lfn„=vsn„,...,lfn =vsn . 

■I 1 . z z n n 

Parameter Description 


Ifrii File name to be associated with vsnj^. This parameter is required if 

parameters are specified. 

^®^i Qn& or more one- to six-character volume serial numbers to be 

associated with Ifnj^. If vsn^j^ contains nonalphanumeric characters, it 
must be a literal delimited by dollar signs ($). 

vsni Meaning 

Omitted An available scratch tape is automatically 

assigned to lfnj_. 

0 Same as omitted. 

SCRATCH Same as omitted. 

vsn^/vsn^^/. . ./vsn^ Successive volumes to be assigned to Ifn^.tt 

The system assigns volumes in the order listed. 

evsn=ivsn Specifies both the external and the internal VSNs 

for the volume. The internal VSN is the VSN 
recorded in the ANSI VOLl label on the tape. The 
external VSN is the "human-readable" VSN on the 
exterior of the tape. For an AT cartridge tape, 
the external VSN is the machine-readable (bar 
code) VSN on the exterior of the cartridge. 

For a multivolume set, if this format is used for 
one volume, it must be used for all volumes. 

With a VSN command you can: 

• Omit the VSN keyword from your LABEL or REQUEST commands and specify Ifn/VSN 
associations on the VSN coTnmand instead. This allows you to specify new VSNs 
without changing LABEL or REQUEST command. 

• Override the VSN specified on subsequent ASSIGN, LABEL, REQUEST, or VSN commands. 

For example, the sequence 

VSN,FILEA=123. 

VSN,FILEA=124. 

LABEL,FILEA. 


•f Up to 60 VSNs can be specified for a single file name in any combination of duplicate reel 
and/or multireel specifications. 

ft All subsequent volumes must have the same characteristics as the first volume in the 

sequence. (Characteristics include labels, track type, density, and conversion mode.) It 
is recommended that all volumes be blank labeled (refer to the BIANK command) before use 
in a multivolmne sequence. 
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directs the system to assign FILEA to the tape with VSN 123. However, by returning 
file Ifn, you can specify another Ifn/VSN association. Thus, the following sequence 
directs the system to assign FILEA to the tape with VSN 124. 

VSN,FILEA=123. 

KETOKN, FILEA. 

VSN,FILEA=124. 

LABEL,FILEA. 

• Specify both the external and internal VSNs of a file for which the VSNs are 
different. For example, the following command indicates that the tape with the 
external VSN of AB0025 and the internal VSN of DATA should be assigned to FILEl. 

VSN, FILE1=AB002S=DATA. 

• Specify the VSNs of a multivolume file set. For example, the following command 
indicates that FILE2 may extend through the three volumes identified by VSN23, 

VSN24, and VSN25. 

VSN,FILE2=VSN23/VSN24/VSN25. 

• Specify the external and internal VSNs for a multivolume set. 

VSN,FILE3=AB0040=DATA1/AB006S=DATA2/AB0123=DATA3. 

The first volume of the set has an external VSN of AB0040 and an internal VSN of 
DATAl; the second volume has an external VSN of AB0065 and an internal VSN of DATA2; 
and the third volume has an external VSN of AB0123 and an internal VSN of DATA3. 
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CHECKPOINT/RESTART 


13 


A job may terminate as the result of system, operator, or programmer error. For some jobs, 
it becomes more advantageous to accept the overhead of checkpoint procedures than to run the 
risk of losing the entire job output. The checkpoint/restart feature is implemented through 
the CKP command and the RESTART command. 


NOTE I 


For information concerning security 
restrictions associated with the use of 
these commands, refer to Security Control in 
section 3. 


CKP COMMAND 

The CKP command causes a checkpoint dump to be taken. 
Format: 


CKP,lfn^,lfn2,••* »^^®n• 

Parameter Description 

Ifnj^ Specifies a file to be Included in the checkpoint diunp. If no files are 
specified, all files local to the job at the time the CKP command is 
processed are checkpointed. 

Each time a CKP command is processed, the system takes a checkpoint dump. The dump is 
written on the tape or mass storage checkpoint file specified on a REQUEST, ASSIGN, or LABEL 
conmand with the CK or CB parameter. The dump consists of a copy of the job's field length 
in central memory, the system information used for job control, and the names and position 
and/or contents of all assigned files explicitly or implicitly identified by the CKP 
command. These files are: 

• INPUT, OUTPUT, PUNCH, PUNCHB, P8, CCCCCCO, and LGO. These files are always Included 
in the checkpoint dump. Procedure scratch files ZZZZZCO, ZZZZZCl, and ZZZZZC2 are 
also included if present. Data files using the default names ZZCCIAA, ZZCCLAB,..., 
and ZZCCLZZ are also Included if present. 

• Library type files, working copies of indirect access files, and some direct access 
files. If one of these types of files is specified on the CKP command, it is 
included in the checkpoint dump, and all other files of that t3rpe are excluded. If 
no files are specified, all files of these types assigned to the job are included in 
the dump. 

The system does not include global library set files (ZZZZZLD and your library files) unless 
you specify them on the command. 

Each checkpointed mass storage file is copied according to the last operation performed on 
it. If the last operation was a write, the file is copied from the BOI to its position at 
checkpoint time; only that portion is available at restart time. The file is positioned at 
the latter point. 
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If the last operation on a mass storage file was a read and the EOI was not detected, the 
file is copied from its position at checkpoint time to the EOI; only that portion is 
available at restart time. The file is positioned at the former point. If the last 
operation was a read and the EOI was detected, no copy is perfoimed. 

Ihe exception to this rule is the type of operation performed on execute-only direct access 
files. If a dump is specified for this type of file, its name and associated system 
information are copied but the contents of the file Itself is not copied. Thus, if you 
attempt to resxme from such a dump, RESX&RT is unable to retrieve that file and aborts. You 
can avoid this by selecting the and FC options of the RESTART command and retrieving the 
file yourself. 

Uhen procedure scratch files are copied, they are copied from BOI to EOI. 

For checkpointed magnetic tape files, only the relative position of the tape is captured so 
that the tape can be properly positioned dxiring restart. Mixed mode 7-track tapes are not 
supported when using CHBCKPOIKT or RESTART. 

If the checkpoint file is to reside on mass storage, you must include a SAVE or DEFIME 
command in the checkpoint job and a GET or ATTACH command in the restart job. 

If the checkpoint file is to reside on magnetic tape, care should be taken to use a labeled 
or nonblank tape. An unlabeled blank tape (one which has never been used) cannot be 
specified as the checkpoint file since the checkpoint program attempts to read the tape to 
determine the number of the last checkpoint. The tape subsystem then aborts the job with a 
blank tape read message. 

The system numbers checkpoints starting at 1 and Increases by 1 to a limit of 4095. At this 
point, a second cycle of numbering begins, again starting at 1. An example showing how to 
restart from a specific checkpoint is given in the RESTART command section. 


RESTART COMMAND 

The RESTART command directs the system to restart a previously terminated job from a 
specified checkpoint. 

Format: 


RESTART,Ifn,nnnn ,Xj. 


Parameter 


Description 


Ifn 


Identifies the checkpoint file; you must have write permission to Ifn. 


nnnn Number of the cteckpoint from which to restart; if nnnn is *, the last 

available checkpoint on Ifn is used; if nnnn is omitted, the first 
checkpoint is used. The nnnn parameter can be obtained from the 
CHECKPOINT nnnn CCMPLETE messages issued to the user's dayfile in 
response to CKP command. 
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Parameter 


Description 


’^i Any of the following in any order: 

RI If this parameter is included, the command file on Ifn is 

not restored. The command file of this restart job at its 
current position is used instead. 

The procedure scratch files ZZZZZCO, ZZZZZCl, and ZZZZZC2 
are not restored from the checkpoint file. The values of 
the symbolic names EFG, EF, RIG, Rl, R2, R3, and DSC of 
this restart job are used, not the values from the 
checkpoint file CPA. 

If this parameter is not included, the entire command file 
of the checkpointed job is restored and set to its 
position at checkpoint time; any command following RESTART 
is not processed. 

NA If this parameter is included, RESTART does not abort if a 

required file is not available. Also, if NA is included 
and a read parity error occurs in an attempt to obtain a 
file from checkpoint nnnn, RESTART selects checkpoint 
nnnn-1 if it is available. 

FC Normally RESTART restores all mass storage files included 

in the specified checkpoint. This option does not restore 
ZZZZZCO, ZZZZZCl, or ZZZZZC2. However, if this option is 
selected, RESTART first checks if a file is already local 
to the restart job. If it is, RESTART does not replace it 
with the file on the checkpoint dump. 

Before you enter the RESTART command, do the following; 

• Assign the checkpoint file to the job. You must Include a REQUEST, ASSIGN, or LABEL 
command if the checkpoint file resides on magnetic tape. You can use a GET or 
ATTACH command if the checkpoint file resides on mass storage. 

• Assign to the job all necessary magnetic tape files to be used by the restarted 
job. You can use the LABEL command. 

Checkpoint dumps are numbered in ascending order from 1 to A095. When nnnn equals 4095, the 
numbering sequence begins again at nnnn equal to 1. The value of nnnn depends on the 
structure of the checkpoint file, as defined by the CK and CB parameters of the REQUEST, 
ASSIGN, or LABEL commands. 

If CK was specified when the checkpoints occurred, each dump is appended to the checkpoint 
file, and therefore, all dumps up to the time the job aborted are available for restart. 

You may specify a particular checkpoint dump in the following manner. 
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Assume a CK file of the name CHKFILE is being used and checkpoint number 4095 has been 
passed. The job is terminated at checkpoint number 10 in the second cycle of numbering. To 
restart the job from checkpoint 4 of the second numbering cycle, the following commands can 
be used. 


SKIPR,CHKFILE,8196. 


COPYBR,CHKFILE,AA,2. 


RESTART,AA... . 


There are two records for every checkpoint, and 4098 
checkpoints must be skipped to reach checkpoint 4 of the 
second numbering cycle. 

The fourth checkpoint is copied to file AA. At this point, 
file CHKFILE is not positioned correctly for subsequent 
checkpoints. If you intend to continue checkpointing on this 
file, a 

BKSP,CHKFILE. 

command should be included. 

The job is restarted from file AA using the fourth checkpoint. 


If the CB parameter was specified on the ASSIGN, LABEL, or REQUEST command naming the 
checkpoint file, each dump is written over the preceding dmp, and therefore, only the last 
dump is available. If two REQUEST, ASSIGN, or LABEL commands with CB specified are 
submitted, successive dumps are alternated between two files; therefore, the last two dumps 
are available.t 


All files copied by RESTART are made local to the restart job. Therefore, you must make 
sure that any direct access files are not lost. For example, assume that direct access 
files X, Y, and Z are attached to a job. The job is then checkpointed and X, Y, and Z are 
copied to the checkpoint file Ifn. To retain these files as direct access files during 
restart, you should include the following sequence of commands. 


PURGE,X,Y,Z. 


DEFINE,X,Y,Z. 

RESTART,lfn,nnnn,x^. 

If the information table associated with a file was Included on the checkpoint file, but the 
file itself was not copied, RESTART issues the appropriate commands to attempt to retrieve 
the file unless one of the following is true: 

• You specified the FC parameter and the file is already local to the restart job. 

• The file resides on magnetic tape. 


tif alternate checlq)oint files are used and a read parity error occurs in an attempt to 
read the last checkpoint, RESTART aborts even if the NA option was selected. 
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SYSTEM UTILITY COMMANDS 


14 


NOS provides the following utilities for file maintenance and screen formatting. 

EDIT Edits a text file. 

FSE Edits a file in line or screen mode. 

KRONREF Generates a cross-reference listing of system symbols. 

MODIFY Edits a Modify-formatted program library file. 

OPLEDIT Removes modification decks and identifiers from a Modify-formatted program 

library file. 

PDU Compiles a panel definition file and loads it in a user library. 

PROFILE Enables a master user to update and inquire about a profile file. 

UPDATE Edits an Update-formatted program library file. 

XEDIT Edits a text file. 

EDIT COMMAND 

The EDIT command calls the Text Editor utility. The Text Editor manipulates data on a 
specified mass storage file through use of special input directives called edit commands. 

Format: 

EDIT,lfn]^,m,lfn 2 ,lfn 3 . 

or 

EDIT,FN=lfn1,M=m,I=lfn2,L=lfn3. 

Parameter Description 

Ifni Name of file to be edited (referred to as edit file). This 

specification is required for batch origin jobs. 

m Mode of file processing: 

ASCII or AS ASCII mode edit file. 

NORMAL or N NORMAL mode edit file. 

Ifn 2 File from which directives (edit commands) are to be read. If 

omitted, INPUT is assumed. 

Ifn 3 File to which output is to be written. If omitted, OUTPUT is assumed. 
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FSE COMMAND 


The FSE command calls the full screen editor FSE. For a complete description of the 
features of FSE and its parameters and directives, refer to the NOS Version 2 Full Screen 
Editor User's Guide. 

Format: 

FSE,FN=filename,OP=access,l=input,L=output,IP=procedure,WF=workfile.directives 
or 


FSE,filename,access,input,output,procedure,workfile.directives 

The first format is the order-independent format for parameters. The second is the 
order-dependent format. 


Parameter Description 


FN=filename Specifies the file you want to edit. The file can be a local file or 
a permanent file. The default is the file most recently edited during 
your job. 

OP=access Specifies the character set code and the location of the file to be 
edited. The following entries are valid; 


I=input 

L=output 


Access Abbreviation 


Description 


DISPLAY D 

or 

NORMAL N 

ASCII A 

ASCIIS 8 

GET G 


Selects 6-bit display code. This 
is the default if your terminal is 
NORMAL mode. 

Selects 6/12-bit display code. This 
is the default if your terminal is in 
ASCII mode. 

Selects 7-bit ASCII code right- 
justified in a 12-bit byte. 

Specifies that the file is a direct 
access or an indirect access permanent 
file. 


To specify both a character set and the location of the file, you must 
specify two values. For example, 0P=8G and OP=AG are valid. 


To specify the OP«access parameter, you must also specify the 
FN=filename parameter. 


Specifies an input file for directives. The default is file INPUT. 
Specifies an output file. The default is OUTPUT. 
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Parameter 


Description 


IP=procedure Specifies a file to be the FSE procedure library. The default 

procedure library is FSEPROC. If file FSEPROC is not a local file, 
FSE automatically retrieves it. If FSEPROC is not one of your 
indirect access permanent files, FSE retrieves a copy from user name 
LIBRARY. 

WF==workfile Specifies a work file for FSE. The default is ZZZWORK. 

directives Specifies FSE directives to be executed before FSE executes those in 

the input file. Use semicolons to separate directives. 

If you specify both an input directive file (using the l=input parameter) and an output 
listing file (using the L=output parameter), FSE is said to be in batch mode. When 
operating in batch mode, the input directive file must be coded in 6/12-bit display code. 


NOTE 


When FSE is executing in batch mode, or when 
the FSE command is Included in a batch job, 
you can significantly Increase processing 
efficiency by disabling UNDO processing 
(using the SET UNDO directive). This action 
inhibits FSE from keeping a record of each 
operation performed. 
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KRONREF COMMAND 


The KRONREF command generates a cross-reference listing of system symbols used by decks on a 
Modify OPL. For output listing files not connected to your terminal, the KRONREF command 
honors the page length and print density set for your job using the SET command and the PL 
and PD symbolic names. 

I note I 

Before entering a KRONREF command specifying 
both OPL and NOSTEXT, you must enter an RFL 
command to reserve sufficient memory to 
contain systems text and OPL contents. 


Format: 


KRONREF,P=lfnj,L=lfn2,S=lfn3,G=lfn4. 


Parameter 


Description 


P=lfni 


OPL input from file Ifnj^. If the P option is omitted or P alone is 
specified, file OPL is assumed. 


L=lfn 2 List output on file lfn 2 . If the L option is omitted or L alone is 

specified, file OUTPUT is assumed. 


S=lfn 3 System text from overlay lfn 3 . The system text must contain symbol 

definitions. If the S option is omitted or S alone is specified, file 
NOSTEXT is assumed. If S=0 is specified, only the common deck 
references and statistics are listed. 


G=lfn 4 System text from local file Ifn^. The system text must contain symbol 

definitions. If G is omitted, system text is acquired as specified or 
defaulted by the S option. If G alone is specified, local file TEXT is 
used. Use of the G option overrides any S specification. 

The names of programs on the OPL are listed for those decks that reference the following: 

• PP direct cell locations defined in Ifn^ or Ifn^. 

• PP resident entry points defined in Ifn^. 

• Monitor functions. 

• Mass storage table words. 

• Global or local file name table words and ordinals. 

• Central memory pointers (in low central memory) defined in Ifn^ or Ifn^. 

• Central memory locations (in low central memory) defined in Ifn^ or Ifn^. 

• Control point area words defined in lfn 3 or Ifn^. 

• Executing job table, equipment status table, or queue file table. 

• Negative field length symbols and dayfile message options. 

• File types and mass storage constants. 

• Job origin types and queue types. 

• Error flags referenced. 

• Common deck calls. 

• PP packages called. 

• Special entry points. 
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MODIFY COMMAND 


The MODIFY conmand edits a Modify-formatted program library file. For output listing files 
not connected to your terminal, the MODIFY command honors the page length and print density 
set for your job using the SET command and the PL and PD symbolic names. 

Format; 


MODIFY,PI,p2,...,Pn. 

The following optional parameters can be specified in any order. 


Pi 


A 

BL 


C=lfni 


CB=lfn 2 


CG=lfn3 


CL=lfn4 


CS=lfn5 


CV=cv 


Description 

Write the compile file in compressed format. 

Write the output listing file in burstable (easily separable) format. 

A new page is started on the output listing for each deck. 

Write compile output on Ifn^. If you specify only C or omit this 
parameter, Ifn^ is COMPILE. C=0 results in no compile output. 

Write binary output on lfn 2 . This parameter is equivalent to the 
B=lfn parameter on a compiler or assembler call command. If you 
specify only CB or omit this parameter, LGO is the binary output 
file. CB=0 produces no binary output. This parameter is meaningful 
only if you specify the Q=processor or X=processor parameter. 

Load system text from lfn 3 . This parameter is equivalent to the 
G=lfn parameter on a compiler or assembler call command. Load system 
text from SYSTEXT. CG=0 loads no system text. By default, the system 
uses the CS=lfn 5 parameter. This parameter is meaningful only if 
you specify the Q=processor or X*processor parameter. 

Write full listing on lfn 4 . CL=lfn 4 is equivalent to the L=lfn 
parameter on a compiler or assembler call command. If you specify 
only CL, OUTPUT is the list file. If you omit this parameter or 
specify CL=0, a short listing is written on OUTPUT. This parameter is 
meaningful only if you specify the Q=processor or X=processor 
parameter. 

Take system text from lfn 5 . This parameter is equivalent to the 
S=lfn parameter on a compiler or assembler call command. If you omit 
this parameter or specify only CS, the system text is taken from 
SYSTEXT overlay. CS=0 produces no system text. This parameter is 
meaningful only if you specify the Q=processor or X=processor 
parameter. 

Convert the library to the character set specified by cv (63 or 64). 
By default, no conversion occurs. 


NOTE I 

When CV=63 or CV=64 is speciied. Modify 
prevents compile file generation (C=0). 
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D 


Pi 


F 


I=lfn6 


L=lfn7 


Description 


Do not abort the job on a directive error. (This parameter is 
referred to as debug mode.) This parameter does not affect fatal 
error processing. By default, the job aborts on a directive or fatal 
error. 

Edit all decks on the library and write them on new program library, 
compile file, and source file if the respective options are selected. 
(This parameter is referred to as full edit mode.) By default, the U 
parameter or EDIT directives determine the decks to be edited. 

Take directives from next record on lfn 5 . INPUT is the default. 

The system reads no directives if you specify 1=0. 

Write list output on lfn 7 . OUTPUT is the default. L=0 generates no 
list output file. 


L0=C]^C2...Cn Select list options ci. In an interactive job, the default 
is LO=E if the list output file is assigned to the terminal. 
Otherwise, the default is L0=ECTMWD. You can specify a maximum of 
seven list options cj. 

Significance 

A Active lines in deck. 

C Directives other than INSERT, DELETE, RESTORE, MODNAME, 

I, or D. 

D Deck status. 

E Errors. 

I Inactive lines in deck. 

M Modifications performed. 

S Statistics. 

T Text input. 

W Compile file directives. 

Example: L0=EMS 

N=lfn 3 Write new program library on Ifng. If you specify only the ke 3 rword 

N, the system uses file NPL. If you omit this parameter or specify 
N=0, the system generates no new program library. 


NOTE 


If a new program library is being generated, 
the system performs an evict operation on 
the file specified by the N=lfn8 parameter. 
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n 

Description 

NR 

Do not rewind compile file. By default, the system rewinds compile 
file at beginning and end of Modify run. 

P'lfng 

Take program library input from Ifng. If you do not specify a file, 
the system takes the input from OPL. P=0 results in no input file for 
the program library. 

Q=processor 

Set L0=E and the A parameter at the beginning of the Modify run and 
call the assembler or compiler specified by processor at the end of 
the run. The system does not rewind the directives file or the list 
output file. If you do not specify this parameter or specify Q=0, no 
call is made to an assembler or compiler. 


If you specify only the keyword Q, the system sets L0=E and the A 
parameter at the beginning of the Modify run and calls the COMPASS 
assembler at the end of the run. When this option is selected, the 
CB=lfn 2 , CL=lfn 4 , CS=lfn 5 , and CG=lfn 3 parameters are 
meaningful. Compiler input is assumed to be COMPILE. All other 
parameters are set by default. If CL is not specified with Q, lines 
beginning with an asterisk in column 1 are not written to the compile 
file (compile file directives are processed). 

S=lfnio 

Write source output on file Ifn^Q* specify only the keyword 

S, the file SOURCE is used. If you omit this parameter or specify 

S=0, the system generates no source output file. 


Do not specify this parameter if you specify the A, Q=processor, or 
X=processor parameter. 

U 

Edit only decks for which the directives file contains deck directives 
and write them on the compile file, new program library, and source 
file (if their respective parameters are selected). F, if specified, 
takes precedence. By default, decks to be edited are determined by 

EDIT directives or by the F parameter. 

X 

Process the same as Q^'processor parameter, except that modify 
directives input (I parameter) and list output (L parameter) files are 
rewound before processing. 

z 

Read the input directives following the terminator of the MODIFY 
command; the input file is not read. This eliminates the need for a 
separate input file for the directives when only a few directives are 
needed. The first character following the command terminator is the 
separator character for all directives on the command. Any display 
code character that is not used in any of the directives, including a 
space, can be used as the separator character. The directives can 
extend to column 80 on the command. Continuation lines are not 
permitted. If Z is omitted, the command does not contain the input 
directives. 


NOTE 


Do not place another terminator after the 
directives. 

For a detailed description of the Modify utility, refer to the Modify Reference Manual. 
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OPLEDIT COMMAND 


The OPLEDIT conmand removes modification decks and Identifiers from a Modify—formatted 
program library file. For output listing files not connected to your terminal, the OPLEDIT 
command honors the page length and print density set for your job using the SET command and 
the PL and PD symbolic names. 

Format: 

OPLEDIT,p]:,p 2 ,...,pj^. 

Pi Description 

I=lfn][ Use directive input from file Infj. Take input directives from file 

Ifnj^. INPUT is the default. 1=0 indicates that there are no input 
directives. 

P=lfn 2 Use file lfn 2 for the old program library. Use file lfn 2 for the 

old program library. OPL is the default. P=0 indicates that there is 
no old program library. 

N=lfn 3 Write new program library on file lfn 3 . Write the new program 

library on If 03 . If you specify only the keyword N, NPL is used. 

If you omit this parameter or specify N=0, the system writes no new 
program library. 

L=lfn 4 List output on file lfn 4 . Place list output on file Ifn^. OUTPUT 

is the default. L=0 generates no list output. 

M=lfn 5 Write output from *PULLM0D directives on file lfn 5 . If this option 

is omitted, M=M0DSETS is assumed. 

L 0 =cic 2 ...Cn Selects up to five list options Cf. 

Ci Description 

E Errors. 

C Input directives. 

M Modifications made. 

D Deck status. 

S Statistics. 

If this parameter is omitted or just LO is specified, it selects all 
list options. If the output file is assigned to the terminal in a 
interactive job and this parameter is omitted or just LO is specified, 
list option E is selected. 


14-8 


60459680 D 




F 


Pi 


Modify all decks. 
Debug; ignore errors. 


Description 


D 

U 


U=0 


Z 


Generate *EDIT directives for all decks; meaningful only for *PULLMOD 
executions. 

Generate no *EDIT directives. If the U option is omitted, generate 
*EDIT directives for common decks. This is meaningful only for 
*PULLMOD execution. 

Read the input directives that follow the terminator. The input file 
is not read. This eliminates the need to use a separate input file 
for the directives when only a few directives are needed. The first 
character following the command terminator is the separator 
character. If Z is omitted, the command does not contain the input 
directives. 


NOTE 


Do not place another terminator after the 
directives. 


For a complete description of the OPLEDIT utility, refer to the Modify Reference Manual. 
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PDU COMMAND 


The PDU command compiles a panel definition file and stores the compiled panel in a user 
library. Refer to the NOS Version 2 Screen Formatting Reference manual for information on 
panels. 

Format: 

PDU,I=panel,L=listing,C=capsule,LIB=libfary,REC=recname,RW=option. 

or 

PDU,panel,listing,capsule,library,recname,option. 

The first format is the order-independent format for the parameters. The second is the 
order-dependent format. Only the first parameter is required. 

Parameter Description 

I=panel Specifies the name of the panel definition file. The file must be 

local. You must specify this parameter. 

L=listing Specifies the name of the listing file. The default is OUTPUT. If 
you specify L=0, no listings are generated. 

C=capsule Specifies the name of the capsule file, the file on which the system 
writes the compiled panel. The default is CAPSULE. If you specify 
C=0, no capsule is generated. 

LIB=library Specifies the name of the local file to receive the capsule. The 
default user library is PANELIB. If you specify LIB=0, the system 
does not store the compiled panel in a user library. 

REC=recname Specifies the name of the panel definition record to be selected for 
processing from the panel definition file. If an asterisk (*) is 
entered, all records are processed. If REC is omitted, the current 
record is processed with no regard to the record name. 

RW=option Specifies if the panel definition file and listing file are to be 
rewound before and after processing. 

option Description 

NO or N Files are not rewound. 

YES or Y Files are rewound. 

If RW is omitted, the files are rewound. 

The PDU command is an interactive procedure. Hence, you can get help information for the 
command and its parameters and be prompted for parameters. If you enter 

PDU? 

the system gives you information about the command itself and prompts you for parameters. 
If you enter 

PDU,parameter? 

the system gives you information about the specified parameter and prompts you for 
parameters. 
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PROHLE COMMAND 


The PROFILE command enables the master user to update and inquire about a project profile 
file for user profile control. Other capabilities of PROFILE (available only to system 
origin jobs) are described in the NOS Version 2 Administration Handbook. For output listing 
files not connected to your terminal, the PROFILE command honors the page length and print 
density set for your job using the SET command and the PL and PD symbolic names. 

Format: 

PROFILE, pp P 2 ,..., Pjj. 

The following optional parameters can be specified in any order. 

Pi Meaning 

I=lfni File Ifni contains input directives for an update (OP=U). If 

omitted, file INPUT is assumed. 

L=lfn 2 File lfn 2 receives output listings. If omitted, OUTPUT is assumed. 

P=lfn 3 File lfn 3 is the project profile file. If omitted, file PROFILC is 

assumed. 

CN=cn Charge number inquiry. All project numbers valid for charge number cn 

are written to output file. Valid only if the OP=I option is 
specified. 

PN=pn Project number inquiry. The control values and all valid user names 

for project number pn are written to the output file. The OP=I and 
CN=cn options must also be specified to use the PN option. 

OP=opt PROFILE processing option. One of the following; 

opt Description 

L Lists portions of the profile file as specified by the 

LO=op parameter. 

U Updates the project profile file with directives supplied 

by the input file. U is the default value for the master 
user if the OP option is omitted. 

T Interactive update. Processing is the same as OP=U, but 

preliminary instructions are suppressed. 

I Inquire option. Output is dependent upon the CN or PN=pn 

parameter specified. 
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Pi 


Meaning 

PROFILE list option (OP=L must be specified). One of the following: 


LO=op 

op Description 

FM Full list of everything accessible on the profile file by 

the master-user. This is the default for a nonsystem 
origin job if the L0=op parameter is omitted. 

CM Charge number list of all charge numbers accessible on the 

profile file by the master user. 

PM Project number list of all project numbers accessible on 

the profile file by the master user. 

Directives are available to the master user as input to PROFILE to add or update information 
concerning each charge number. The input file for a PROFILE update (OP=U) is divided into 
groups of entries that each begin with a charge number directive. Each directive following 
a particular charge number entry applies only to that charge number, until another charge 
number entry occurs. 

Each line of the input file can contain one or more directives (up to 72 characters per 
line) in the following format. 

dir^ ,dir2,... jditjj 

Each directive is separated by a delimiter which can be any special character (display code 
greater than 443 ) except an asterisk (*). 

An end-of-line or end-of-card also delimits directives. The following directives are 
available to the master user for PROFILE input. 

dirj Description 

APN=pn Adds or activates project number pn. 

AUN=un Adds user names un (must be preceded by PN directive). 

/cn Specifies the charge number cn to which the following directives 

apply. If this form of charge number specification is used (refer to 
CN=cn directive), it must begin in column 1 with the slant (/). 

CN=cn Same as /cn except that it can begin in any column. 

DPN=pn Deactivates project number pn. This directive does not delete the 

specified project number entry but sets its status such that it cannot 
be specified by users. 

DUN=un Deletes user name un from the list of those who may access the project 

number (must be preceded by PN directive). 

EM=fn Specifies the indirect access permanent file that contains the 

epilogue to be associated with the specified project. The epilogue 
can be a procedure or a binary program. A null entry, which is the 
default, clears the project epilogue. 
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diti 

EPW=pw 

EUN=un 

ISV=x 

PCR=option 


PEX= 3 ?ymmdd. 

PFN=fn 

PN=pn 

PPW=pw 

PDN=un 

SMA=acc 

SML=lim 


Description 

Specifies the file password associated with the project epilogue 
file. A null entry, which is the default, indicates that no password 
is associated with the file. 

Specifies the user who owns the project epilogue file. A null entry, 
which is the default, indicates that the owner of the project epilogue 
file is the user on whose behalf the epilogue is to run. 

Sets X as the maximum SRD accumulation for any job using the charge 
nmber and project number specified by preceding CN and PN directives. 

Defines the conditions under which the system sets a charge-required 
state after the project prologue executes. You can specify one of the 
following values: 

Option Description 

U Set a charge-required state unconditionally. 

A Sets a charge-required state only if the project 

prologue aborts. 

null Does not set a charge-required state. This is the 

default. 

Specifies expiration date for project number of preceding PN 
directive. If PEX=0 is entered, the project number is not limited by 
an expiration date. 

Specifies the indirect access permanent file that contains the 
prologue to be associated with the specified project. The prologue 
can be a procedure or a binary program. A null entry, which is the 
default, clears the project prologue. 

Project number for which the following directives (until the next PN 
directive) apply. 

Specifies the file password associated with the project prologue 
file. A null entry, which is the default,indicates that no password 
is associated with the file. 

Specifies the user who owns the project prologue file. A null entry, 
which is the default. Indicates that the owner of the project prologue 
file is the user on whose behalf the prologue is to run. 

Sets the current number of accumulated SRUs the project number has 
used (PN directive required). This accimulator is updated at the end 
of a job or terminal session and each time a CHARGE command is 
entered. When the SMA value surpasses the SML value, the project is 
not available to users until either the limit or accumulator is 
respecified. 

Specifies the maximum number of accumulated SRUs the project (PN 
directive) may use. SML=0 implies no restriction. 
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Description 

TI=ti Specifies the time of day before which the project number specified by 

the PN directive cannot be used. The time is specified in 24-hour 
clock notation. For example, a ti specification of 1315 indicates the 
project number cannot be used before 1:15 in the afternoon. 

TO=to Specifies the time of -day after which the project number specified by 

the PN directive cannot be used. The time is specified in 24-hour 
clock notation. For example, a to specification of 1315 indicates 
that the project number cannot be used after 1:15 in the afternoon. 


UPDATE COMMAND 


The UPDATE command creates, edits, or copies an Update—formatted program library file. For 
complete information on Update directives and processing, refer to the Update Reference 
Manual. 

Format: 

UPDATE,Pi m 

»P2, . •. ,Pn. 

The parameters are optional and can be specified in any order. 

For file-specifying parameters (those associated with the ke 3 ?words C, G, I, K, N, 0, S, or 
T), you can append either the digit 6 or 8 (but not both) to the keyword. Each 
file-specifying parameter has its own default for the character code set of the file (refer 
to Character Sets in appendix A). The digit 6 or 8 overrides this default. The digit 6 
directs the system to represent the file in the 6-bit display code set. The digit 8 directs 
the system to represent the file in the 7-bit ASCII code set.t However, the system uses the 
ASCII code set only if the digit 8 is appended to the keyword and if the input file is also 
represented in the 7-bit ASCII code set. For example, C8=F1LE directs the system to write 
the decks on the compile file FILE in the ASCII code set. 

Pi Description 

A Copies the old sequential access program library to a new random 

access program library. 

B Copies the old random access program library to a new sequential 

access program library. 

Specifies the compile file. Unless otherwise specified, the compile 
file has the same character code set as the old program library. 
C=PUNCH Implies the D and 8 parameters. C=0 implies no compile file. 
If you omit this parameter or specify the keyword only, COMPILE 
becomes the compile file. If you specify the K=lfnj^ parameter, the 
parameter is ignored. 


tThe digit 8 directs the system to represent the file in the 6/12-bit display code set if 
the job is interactive and the file is an input or output file. 
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Description 


Pi 


D Sets the width of the compile file to 80 characters. The default is 

72. 

E Edits the old program library. To completely edit the library, 

specify the E parameter on two UPDATE commands. The first occurrence 
of the E parameter causes the system to rearrange the directory to 
reflect the actual order of the decks on the library and to remove 
previously purged identifiers. The second occurrence of the E 
parameter causes the system to remove the identifiers that exist only 
as directory entries. 

F Specifies full Update mode. 

G=lfn 2 Specifies the output file for the PULLMOD directive. Unless otherwise 

specified, the character code set of lfn 2 is the same as that of the 
old program library. If you do not specify lfn 2 , the output from 
the PULLMOD directive is appended to the source file (specified by the 
S=lfng parameter). 

H=n Specifies whether a 63- or 64-character character set is to be used in 

the Update run. 

n Description 

3 A 63-character character set. 

4 A 64-character character set. 

omitted Character set that was used in the old program library. 

I=lfn 3 Specifies the primary input file. The default is INPUT. The default 

character code set is 6/12-bit ASCII code if INPUT is associated with 
the terminal. Otherwise, it is display code. 

Specifies the compile file and specifies that the decks are written to 
that file in their order of appearance in the COMPILE directives. The 
default is file COMPILE. The default character code set is 6-bit 
display code. 
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Description 


Pi 

^<= 102 . 


M=lfn4 

N=lfn5 


••cn Specifies one or more of the following list options. 

“^i List Options 

A Lists deck names and correction set Identifiers, COMDECK 

directives, definitions, and decks written on the compile 
file. 

F Uses all list options except 0. 

0 Suppresses all listing. 

1 Lists lines in error. 

2 Lists active Update directives. 

3 Notes on each line that changed status during current 
execution. 

4 Lists text lines. 

5 Lists active compile file directives. 

6 Lists active and inactive lines. 

7 Lists all active lines. 

8 Lists all inactive lines. 

9 Lists correction history of all lines selected by list 
options 5, 7, and 8. 

The default depends on the nature of the Update processing. For a 
creation run, the default is options A, 1, and 2. For a correction 
run, the default is A, 1, 2, 3, and 4. For a copy run, the default is 
A and 1. 

Merges lfn 4 and the old program library. If you specify only the 
keyword M, the system merges the file MERGE and the old program 
library. The two libraries must have the same character code set. If 
the parameter is omitted, no merging occurs. 

Specifies the new program library. If you do specify a new program 
library on a correction run, no new program library is generated. 
Otherwise, the default is the file NEWPL. The default character code 
of the new program library is the same as that of the old program 
library unless the primary input file is in 7-bit ASCII code and the 
old program library is in 6-bit display code. In this case, the 
default is the 7-bit ASCII code set. 
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Pi 


Description 


Specifies the output file. The default is OUTPUT. The 
default character code is the same as that of the old program 
library. 

..,/Sj Specifies file Ifny as the old program library. If just 
the keyword P-is specified, file OLDPL is assumed. If 

®l/s2/.../s7 is specified, secondary old program 
libraries will reside on files ,s2,...,s7. 

Q Processes only decks on COMPILE directives (quick mode). 

^“*^102...c4 Rewind specified files before and after the Update run. 


S=lfn3 


T=lfn8 


U 

W 


X 

8 


^i Files 

C Compile file. 

N New program library. 

P Old program library and merge library. 

S Source and PULLMOD files. 

If *^1 is omitted, no files are rewound. If 

'^“‘^lc2. ..c4 is omitted, the old program library, new 
program library, compile file, source file, and PULIMOD file 
are rewound. 

Specifies the name of the source file. If you specify the 
keyword only, the file SOURCE becomes the source file. If you 
omit the parameter, the system does not write a source file 
unless you specify the T-lfng parameter. The default 
character code set of the source file is the same as that of 
the old program library. 

Functions the same as the S=lfn8 parameter, except that it 
excludes common decks from the source file. This parameter 
takes precedence over the S=lfn8 parameter. 

Specifies that Update processing is to continue even if 
normally fatal errors occur. 

The new program library is written in sequential access 
format. If W is omitted, the new program library is written 
in random access format unless the file is on magnetic tape. 

Writes the compile file in compressed format. If X is 
omitted, the compile file is not compressed. 

Writes compile file output as 80-character line images. If 8 
is omitted, the compile file is written as 90-character line 
images. 
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Pi Description 

*=char The master control character (first character of each directive) for 

this Update run is char, which can be any character having a 6-bit 
display code octal value in the range 01 through 54 except for 51 and 
52 (the open and close parentheses). If this option is omitted, the 
master control character is *. 

/=char The comment control character for this Update run is char, which can 

be A through Z, 0 through 9, or + -*/$=. The character should not be 
changed to one of the abbreviated forms of the directives unless 
NOABBREV is in effect. If this option is omitted, the comment control 
character is a slant bar. 


XEDIT COMMAND 

The XEDIT command calls the text editor, XEDIT. For a complete description of XEDIT 
parameters and directives, refer to the XEDIT Reference Manual. 


NOTE I 


When XEDIT encounters lines longer than 150 
characters it truncates those lines without 
warning; therefore, you should use caution 
when calling XEDIT to edit a file that may 
contain lines longer than 150 characters or 
when editing an ASCII file in NORMAL mode. 


Format: 


XEDIT,lfni,pj,P 2 ,....p^.directives 

All parameters are optional. The following are brief parameter descriptions. 
Parameter Description 


Ifnj Use Ifnj as the name of the file to be edited or created. If Ifnj 

is omitted (indicated by two separators before other parameters), the 
primary file Is edited. 

Pi Description 

AS Edit Ifnj In ASCII Interactive mode. After the 

XEDIT job step, processing returns to the original 
mode. 

B Process the job as a batch origin job. 

C Create a new file Ifnj. 

FR Take the first editing directive from the first line 

of Ifn^. 
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Parameter 


Description 


directives 


Pi Description 

I=lfn 2 Take editing directives from lfn2. By default, 

directives are taken from file INPUT. If you specify 
1=0, the system takes all directives from the trailing 
delimited directive sequence. (If the FR parameter is- 
also specified, the system processes the delimited 
directive sequence after processing directives from 
the first line of Ifn^,) 

L=lfn 3 Put all XEDIT output on the specified file. OUTPUT is 

the default. If you specify L=0, the system 
suppresses all output. 

LK XEDIT processes the edit file in look-only mode. The 

edit file can be examined, but not modified. 

NH Suppress printing of the XEDIT header. 

P Retrieve and edit permanent file Ifn]^. Direct 

access files are attached in write mode. If P is 
omitted, the file Ifn^ is assumed to be a local file. 

Process the directives that follow the command terminator. The first 
character that follows the terminator delimits the directives. The 
value directives has the following form (the semicolon seirves as the 
delimiter): 

;directivei ;<iirective 2 ;... ;directiven 

Do not place a terminator after the last directive. 
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LIBRARY MAINTENANCE 


15 


A library is a file containing records that a.re accessed individually. This section 
describes the creation and maintenance of user libraries. User libraries are not to be 
confused with program libraries. User libraries are created using the LIBGEN, ULIB, PDU, or 
TDU commands. A user library can be named in an LDSET or a LIBRARY command to establish a 
local or global library set. Program libraries are source code libraries, created and 
edited using either the Modify utility or the Update utility. 

This section describes file access methods, library record types, and the following commands 
and their functions. 

Command Function 


CATALOG 


Describes the records on a file. 


COPYL and COPYLM Copies an old file to a new file, updating the records from a 

replacement file. 

GTR Appends records selected from one file to another file. 

ITEMIZE Describes the records on a file. 


LIBEDIT 

LIBGEN 

LIBRARY 

ULIB 

VFYLIB 


Generates a file containing records from one or more other 
files. The records may be of several types. 

Generates a user library; that is, a library of relocatable, 
capsule, absolute, CP overlay, or procedure file records that can 
be accessed by the CYBER Loader. 

Specifies a global library set for the job. 

Creates or modifies a local copy of a user library. 

Compares the records in two files and lists their differences. 


We recommend that, except for files consisting solely of S-type and/or U-type records, only 
the CATALOG and ITEMIZE commands be used on files structured by the CYBER Record Manager 
(CRM). Because of certain incompatibilities with NOS file structures, the output from 
commands other than CATALOG and ITEMIZE may not reflect the CRM file structure accurately. 


LIBRARY RLE ACCESS METHODS 

The methods used to access records within NOS files are sequential access and random access. 

To access a record sequentially, NOS rewinds the file to BOI and then reads records until it 
finds the requested one. To replace, insert, or delete records from a sequential access 
file, NOS must rewrite the entire file. (Records can be appended at EOI without rewriting 
the file.) 
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RELATIVE 

PRU 

ADDRESS 


record^ 

DIRECTORY CONTENTS 

record^ 


record2 
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record^ 

5 
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directory 


record2 

6 

17 




recordj 

8 
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Figure 15-1. Random Access File Structure 


To access a record randomly, the file must be on mass storage and must have a directory 
containing the address of each record (figure 15-1). The GTR, LIBGEN, and LIBEDIT commands 
can generate random access directories. Records within a file can then be replaced, 
inserted, or deleted by rewriting the directory instead of rewriting the entire file. 
Records within a random access file can also be accessed sequentially. 


LIBRARY RECORD TYPES 

NOS determines the type and the name of a record from information contained within the 
record. If the record begins with a prefix cable, the record name (if any) is obtained from 
that table and the type of the record is determined from the first word following the prefix 
table. Otherwise, the type and name (if any) of Che record are determined from the first 
and second words of the record. 

Prefix tables exist, unless they have been specifically suppressed, for: 

• Assembled or compiled programs. 

• System text overlays. 

• User library header records and directory records. 

• Modify program library decks, common decks, or directory records. 

The prefix table consists of a header word with an octal table type identifier followed by 
varying amounts of control information. 

The prefix table is identified by octal digits 7700 in bits 59 through 48 of its first word; 
consequently, it is often referred to as a 77 or 7700 table. Information in the prefix 
table, which originates with the assembler, compiler, or other program that creates the 
Cable, can specify items such as the date created and the system on which the job was 
processed (refer to the CYBER Loader Version 1 Reference Manual). 
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If a prefix table is not present, the first word in a record is examined. If a record meets 
the criteria for a given type of record, the utilities identify it as such. For instance, a 
load file beginning with a Job command may be identified as type TEXT, depending on the 
particular characters in the Job command. 

Although some of the records may contain display coded data (loader directives, for 
example), they are considered binary records. 

The following record types can be specified on the COPYX, GTR, and LIBEDIT commands and are 
recognized by the CATALOG and VFYLIB commands. You determine the record types contained in 
a file by issuing a CATALOG command naming the file. VFYLIB lists the differences between 
the record types of two files. LIBGEN generates a user library from relocatable (REL) 
capsule (CAP), absolute (ABS), CP overlay (OVL), or procedure file (PROC) records. 

Record Type Meaning 


ABS Central processor overlay capsule containing multiple entry points. 

CAP CYBER Loader capsule. 

OPL Old program library deck created by Modify. 

OPLC Old program library common deck created by Modify or LIBEDIT. 

OPLD Old program library directory created by Modify or LIBEDIT. 

OVL Central processor overlay. 

PP Peripheral processor program. 

PPU Peripheral processor unit (first-level peripheral processor) program. 

PROC Procedure file. 

REL Relocatable central processor program. 

TEXT Data file (none of the other record types). 

ULIB User library directory. 

The following record types are recognized by COPYL, COPYLM, and ITEMIZE commands. 

Record Type Meaning 

ABS Central processor overlay capsule containing multiple entry points. 

ACF Modify compressed compile file. It has no record name. This record type 

is determined by a nonzero value in bits 17 through 0 in the second word of 
the 77 table. 

CAP CYBER Loader capsule. 

OPL Old program library deck created by Modify. 

OPLC Old program library common deck created by Modify. 
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Record Type 


Meaning 


OPLD Old program library directory created by Modify or LIBEDIT. 

OVCAP Central processor overlay capsule. 

OVL Central processor overlay. 

PROC Procedure file. 

REL Relocatable central processor program. 

TEXT Data file (none of the other record types) 

UCF Update compressed compile file. It has no record name. This record type 

is determined by a 77 table with a zero word count. 

ULIB User library directory. 

UPLx Update sequential program library with master control character x. It has 

no record name. This record type is determined by no 77 table and the 
characters CHECK in bits 59 through 30. Control characters are obtained 
from bits 5 through 0. 

UPLR Random program library deck created by Update. 

UPLRC Random program library common deck created by Update. 

6PP 6000 series peripheral processor program. 

7PP 7000 series peripheral processor program. 

8PP CYBER 180 peripheral processor program. 


Appendix G in Volume 4, Program Interface, contains the formats of PP (6PP), OPL, OPLD, 

ULIB, TEXT, and PROC records. (The OPLC record format is identical to that of the OPL 
record.) The Modify Version 1 Reference Manual describes how to create ACF, OPL, OPLC, and 
OPLD records. The CYBER Loader Version 1 Reference Manual contains the formats of ABS, CAP, 
OVCAP, OVL, PP, and REL records. The CYBER Loader Instant contains the PPU (7PP) record 
format. The Update Version 1 Reference Manual contains the formats of UCF and UPLx 
records. Section 4 describes the creation of procedures (PROC). 
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CATALOG COMMAND 


The CATALOG command lists information about each record in a file assigned to the job. The 
record types recognized by CATALOG are listed in Library Record Types in this section. 


NOTE I 


CATALOG produces unpredictable results when 
attempting to catalog an S, L, or F format 
tape. Use the COPY command to convert the 
S, L, or F format tape to a mass storage 
file or to an I or SI binary format tape 
before attempting to catalog the file. 


Format; 


CATALOG,Ifn,pi ^-^ 2 ,... ,pn. 

Parameter Description 

Ifn Specifies the file to be cataloged. The default is FILE. 

Pi Pi can be any of the following: 

Pj Description 

N=n Catalogs n files. If n is 0, the system catalogs the 

file until an empty file is encountered (two consecutive 
EOFs). If you specify only the keyword N, the system 
catalogs until it encounters the EOI. The default is 
N=l. 


L=:fname Specifies the name of the output file; if L=fname is 
omitted, CATALOG assumes L=0UTPUT. 

T Lists the entire text record if the record name begins 

with any of the following characters: 

APRD IPRD 

CMRD LIED 

EQPD 


If you omit T, the system does not list the contents of 
the text record. If the text record name begins with 
OVERLAY, the system always lists the first line of the 
record. 


U Lists all records within a user library. If file Ifn is 

a user library and you omit U, CATALOG lists only the 
ULIB record. 

D Suppresses the comments field; suppresses all page 

headings after the initial page heading for each file. 

CS Suppresses character set indicator (63 or 64) for OPL 

and OPLC records. 

R Rewinds Ifn before and after cataloging; if R is 

omitted, Ifn is not rewound. 


60459680 C 


15-5 




The listing for each file of a multifile file begins on a new page with a page heading for 
that file. If the D option has been specified, the page heading appears only once, at the 
beginning of the file. For CATALOG listing files not connected to a terminal, you can 
control the print density and page length using the SET command and the PL and PD symbolic 
names. The information listed under each heading is as follows; 


Heading 


EEC 

NAME 


TYPE 

LENGTH 


CKSUM 


DATE 

COMMENTS 


Information 


Record number (zero-length records and EOF marks are counted). 

Record name [the contents of the name field from the second word of the 
prefix (77) table, if present; otherwise, the first seven characters of 
the record]. For ABS and REL records, the entry points are listed 
beneath the record name. 

Record type (refer to Library Record Types in this section). 

Record length in words, printed as an octal number. For TEXT records, 
this includes the prefix table length. For PROC records, this contains 
the actual record length. For other record types, the prefix table 
length is not included. 

A checksum (that is, a value used to verify that the contents of a 
record were copied correctly). Except for TEXT records, the checksum 
does not verify the contents of the prefix table. 

Record creation date (taken from the third word of the prefix table, if 
present). 

Comments are taken from the comments field of the prefix table. A zero 
byte or a COPYRIGHT comment in the comments field of the table 
terininates the listing. This field is not shown when CATALOG Output is 
assigned to a terminal file.) 


CATALOG lists additional Information depending on the record type. Entry points are listed 
for REL and ABS records. The character set used, correction identifiers, and their YANK 
status (refer to the Modify Reference Manual) are listed for OPL and OPLC records. 


I NOTE 


When printing output for text files, CATALOG 
uses the first seven characters of the first 
word of the record as the record name. 

CATALOG assumes that the record is in 6-bit 
display code. Therefore, if you attempt to 
display CATALOG output for a record in 6/12 
display code while your terminal is in ASCII 
mode, the output display may be garbled. To 
avoid this problem, you should set your 
terminal to NORMAL mode before listing 
CATALOG output. 

A ULIB record suppresses listing of the other records in the user library unless the U 
parameter is specified on the command. 

If an OPLD record in the user library is not encountered before an EOF or EOI within the 
cataloged file, the following message is output before the *EOF* or *EOI* line. 

*OPLD MISSING* 


15-6 


60459680 E 



When a zero-length record is encountered, the length since the last zero-length record is 
given. If an EOR does not precede an EOF or EOI within the cataloged file, the following 
message is output before the *EOF* or *EOI* line. 

*EOR MISSING* 

The ITEMIZE command is similar to the CATALOG command, but ITEMIZE recognizes additional 
record types (refer to Library Record Types, earlier in this section). 

Example: 

Compilation of the FORTRAN program SUBROUT and its subroutines SUBl, SUB2, and SUB3 wrote 
relocatable object code on file LGO. The following is a catalog of file LGO (refer to the 
heading definitions given earlier). 



CATALOG 

OF LGO 

FILE 

1 


REC 

NAME 

TYPE 

LENGTH 

CKSUM 

DATE 

1 

SUBROUT 

SIBROUT 

REL 

44 

6215 

yy/mm/dd. 

2 

A 

A 

REL 

41 

7424 

yy/mm/dd. 

3 

B 

B 

REL 

41 

0465 

yy/mm/dd. 

4 

C 

C 

REL 

41 

5525 

yy/mm/dd. 

5 

* EOF * 

SUN = 

207 




COPYL AND COPYLM COMMANDS 

The COPYL and COPYLM commands copy an old file to a new file, substituting records from a 
replacement file for the matching records on the old file. Records on the replacement file 
which do not match records on the old file are either Ignored or appended to the new file 
according to your parameter specifications. Records are considered to match if they have 
the same type and same name. However, you may specify that the record type be ignored. The 
COPYL and COPYLM commands are commonly used to maintain files of procedures or relocatable 
records. 

The COPYL and COPYLM commands differ only in the handling of multiple occurrences of a 
record on the old file. The COPYL command uses each record on the replacement file only 
once, replacing the first matching record from the old file. The COPYLM command uses the 
first matching record encountered on the replacement file to replace each matching record 
from the old file. The COPYL command can be used to replace multiple occurrences of the 
same record if multiple occurrences of the record are in the replacement file. 

The old file and the replacement file must reside on mass storage or an I or SI format 
tape. Only a single file terminated by an end-of-file marker is processed by a single call 
to the COPYL or COPYLM command unless you request processing to the end-of-information by 
using the E processing option. When working with multifile files, you must be sure to 
position the multifile file to the file that is to be processed. 

The order of the records on the replacement file is not significant except when you use the 
COPYL command to replace multiple occurrences of the same record (with multiple occurrences 
of that record on the replacement file). The system copies the records to the new file in 
the same order as they are on the old file. 
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The COPYL and COPYLM commands issue dayfile messages during processing; no other printed 
output is produced. The dayfile messages list which replacement records were copied and 
which replacement records were not copied to the new file. 

The COPYL and COPYLM commands replace only the record types listed in Library Record Types, 
earlier in this section. Any record on the old file that is not recognized as one of the 
listed types is copied to the new file without further processing. Any replacement file 
record type that is not listed in Library Record Type, is Ignored without comment. 

Format: 

COPYL,oldlfn,replfn,newlfn,last,flag. Single replacement, 

or 

COPYLM,oldlfn,replfn,newlfn,last,flag. Multiple replacement. 

All parjuneters are optional and order-dependent. You denote an omitted parameter by 
consecutive commas. 

Parame ter Description 

oldlfn File name of the old file. Default name is OLD. 

replfn File name of the replacement file. Default name is LGO. 

newlfn File name of the updated file. Default name is NEW, 

last Name of the last record on oldlfn to be processed. If last is not 

specified, all records on oldlfn are processed from its current 
position to the next EOF (or EOI if the E processing option is used). 

flag Processing options. 

flag Description 

A Append to the end of newlfn all replfn records that do not 

match any records on the oldlfn. If A is not selected, 
records on the replacement file that do not match any 
records on the oldlfn are Ignored and a dayfile message is 
issued. 

E Process oldlfn until the end-of—information. 

R Rewind oldlfn and newlfn files before processing. (The 

replfn file is always rewound before and after 
processing, oldlfn and newlfn are not necessarily rewound 
to beginning-of-information in multifile files. Refer to 
explanation below.) 

T Check for matching name of record, but omit check for 

matching type of record. If T is not selected, records 
match only if both the type and name of the records are 
the same. 

These options can be specified by combining one or more letters in any 
order, such as TRA, AR, ERTA, or TR. 

The COPYL and COPYLM commands check only the first four flag options. 
If more than four are specified, the remaining characters are ignored. 
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The R option affects file positioning of the old and new files before processing. If R is 
specified, the old and new files are rewound before processing. In a multifile file, if 
there is one or more end-of-file markers between the current position of the file and the 
beginning-of-information, the R option rewinds the file to the first preceding EOF. In the 
absence of R, you are responsible for positioning the oldlfn and newlfn files. The R option 
does not affect the file of replacement records, since the current file of the replacement 
file always is rewovind to the beginning-of-information before and after processing. 

The E option causes the old file to be processed to the end—of-information. Each 
end-of-file encountered on the old file causes a matching end-of-file to be written on the 
new file. Records that are added to the new file as a result of combining the A and E 
options are appended with an end-of-file prior to the end-of-lnformation. In this case, 
such appended records will follow an end-of-file if both end-of-file and end—of—information 
existed at the end of the old file. 

Processing stops after an end-of-file, end—of—record, or end-of—information is reached, 
depending on the structure of the old file and the processing options selected. If 
processing stopped because end-of-file or end-of-record was reached, the old file is 
positioned after that EOF or EOR. If processing stopped because end-of—information was 
reached, the old file is positioned just prior to the end-of-information. 

COPYL and COPYLM add an end-of-file to the new file even if no end-of-file is encountered on 
the old file. No further positioning of the new file takes place. 
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Example 


The following COPYL command updates OLDFILE with replacement records from EEPFILE and writes 
them on NEWFILE. The A option appends to the end of NEWFILE any records in REPFILE that do 
not match a record on OLDFILE. 

C 0 PYL,OLDF ILE, RE PFILE, NEWFILE ,, A. 

The following dayfile segment shows that COPYL updated the record named B and appended the 
record named C. 

08.53.23.COPYL,OLDFILE,REPFILE,NEWFILE,,A. 

08.53.2A. UPDATED — PROC / B 
08.53.24.APPENDED — PROC / C 
08.53.24. COPYL COMPLETE. 


The ITEMIZE command show the record information for all records in OLDFILE, BEPFILE, and 
NEWFILE. 


/iteiiii 2 e,oLdfi Le 



ITEMIZE OF 

OLDFILE 

FILE 

1 

REC 

NAME 

TYPE 

LENGTH 

CKSUM 

1 

A 

PROC 

4 

3310 

2 

B 

PROC 

4 

5306 

3 

(00) 

SUM = 

10 



* EOI * 

SUM = 

10 


ITEMIZE COMPLETE. 




/itemize, 

,repf i Le 





ITEMIZE OF 

REPFILE 

FILE 

1 

REC 

NAME 

TYPE 

LENGTH 

CKSUM 

1 

B 

PROC 

4 


2 

C 

PROC 

4 



* EOI * 

SUM = 

10 


ITEMIZE 

COMPLETE. 




/itemize 

,newf i Le 





ITEMIZE OF 

NEWFILE 

FILE 

1 

REC 

NAME 

TYPE 

LENGTH 

CKSlfl 

1 

A 

PROC 

4 

3310 

2 

B 

PROC 

4 

1535 

3 


SUM = 

10 


4 

C 

PROC 

4 

7304 

5 

* EOF * 

SUM = 

14 



DATE 


DATE 


DATE 


ITEMIZE COMPLETE. 
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GTR COMMAND 


The GTR command extracts records selected from one file and writes them on another file. 

The records are selected according to directives specifying their type and name. (Refer to 
Library Record Types in this section for the list of valid record types.) Records can be 
accessed randomly (default if a directory exists) or sequentially. If specified, a random 
access directory is appended to the changed file. The system writes an EOF after the 
directory. 

Positional format: 


GTR,Ifni»lfn 2 ,d,NR,S,NA,T.directivei,directive 2 ,...,directivejj 


Keyword format: 

GTR,lfni,lfn2/pi,P2*•.,pn.directivei,directive 2 .directivejj 


NOTE I 


In positional format, the parameters must be 
in the order shown. Parameters are 
identified by their position, not by 
keywords. An omitted parameter is denoted 
by consecutive commas. 

In keirword format, parameters preceding the 
/ are still processed in positional format, 
but those which follow it (pi,p2,...,pn) are 
recognized by keyword, and may occur in any 
order. The keywords are the same as the 
suggested values for the positional format 
parameters: U, D, NR, S, NA, and T. 

Keywords U and D are covered under 
positional parameter "d" in the explanation 
of parameters which follows. 

In either format, do not place blanks 
between the terminator (right parenthesis or 
period) and directivei. Also, do not 
place a terminator after directiven* 


Parameter 


Description 


Ifni File which is searched for the requested records; if Ifni 

omitted, file OLD is assumed. Ifni is always rewound before the GTR 
operation. 

Ifn 2 File on which the selected records are written; if lfn 2 is omitted, 

file LGO is assumed. For disk files, GTR always positions lfn2 at . 
EOl before copying the selected records. GTR only appends records to 
tape files when you specify the NR parameter. Otherwise, GTR starts 
writing on tape files at their BOI. 
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Parameter 


Description 


d Random access directory parameter. If d is specified, lfn 2 must be 

a mass storage file. GTR cannot append records after a directory. 

If Ifni ® random access directory and if sequential access (the 
S parameter) is not specified, the lfn 2 directory record is given 
the same name as the Ifnj directory record. Otherwise, the lfn 2 
directory record is named lfn 2 . 

_d Description 

omitted No new random access directory (OPLD) is added to 
lfn2* If the directives specify the user library 
record type (ULIB), the first record of the user 
library (ULIB) is not copied to lfn 2 . The second 
and subsequent records are copied, and the last record 
(OPLD) is copied without alteration. The system does 
not write an EOF at the end of the file. 

U No new random access directory (OPLD) is added to 

lfn 2 . If the directives specify the user library 
record type (ULIB), the first record of the user 
library (ULIB) is copied without alteration to lfn 2 
along with the remainder of the library, including the 
OPLD. The system does not write an EOF at the end of 
the file. 

D or other Writes a new random access directory (OPLD) at the end 
of lfn 2 . If the directives specify the user library 
record type (ULIB), the first record of the user 
library (ULIB) is copied without alteration to lfn 2 
along with the remainder of the library, including the 
OPLD. The system writes an EOF after the new 
directory. 


NOTE 


The new random access directory contains 
entries only for records specified on 
the current GTR command. To build a new 
random access directory which contains 
entries for all records on lfn2, use 
LIBEDIT. 


NR No rewind option. Ifni rewound after the operation; lfn 2 

is not rewound before or after the operation. If Ifni has a 
directory, the directory is copied to lfn 2 . 

If NR is omitted, both files are rewound after the operation, but only 
when lfn2 is a tape file is lfn 2 rewound before the operation. 
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Parameter 


Description 


S 


Ifnj^ is searched sequentially; no attempt is made to read a directory. 


NA 


T 


No abort option. If specified, GTR does not search for an EXIT command 
when an error occurs. It issues a dayfile message for the error and 
continues GTR processing at the next directive. 

TEXT record name removal option. If specified, the line containing the 
record name (the first line of the record) is removed for each selected 
TEXT type record when the record is written to lfn2. 


directive^ Specifies a record or group of records to be retrieved. One or more of 
the following formats can be used. Valid record types are listed under 
Library Record Types in this section. The default type is the last type 
specified on a directive, or if none is specified, TEXT. The record 
name is the first seven characters of the record, or if a prefix table 
is present, the contents of the name field in its second word. 


Directive 
type/name 
name 


Meaning 

Record with the specified type and name. 

Record with the specified name and the 
default type. 
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Parameter 


Description 


Directive 


Meaning 


type^/name j^-type2/name2 


Group of records beginning with 
namej^ of typei and ending with 
name 2 of type 2 « 


X / name i -name 2 


namename2 


type/name-* 


Group of records beginning with namei 
of typeI and ending with name2 of 
type^. 

Group of records beginning with namei 
of the default type and ending with 
name 2 of the default type. 

All records of the specified type 
beginning with the named record. 


name-* 


All records of the default type beginning 
with the named record. 


type/* 


All records of the specified type. 


All records of the default type. 


0 


A zero-length record is inserted. 


GTR searches file Ifnj^ for the records specified by the selection directives. If GTR 
cannot find a record specified by type and name, it issues the following dayfile message. 

GTR ERRORS. 


If also issues this message when the record specified is within a user library and when the 
GTR command syntax is incorrect. 

If Ifnj has a directory (OPLD) record, GTR writes the selected records on lfn2 in the 
order specified on the GTR command. If lfn 2 does not have a directory record, GTR writes 
the selected records in the order that it finds them on Ifn^, rather than in the order 
specified on the command. 


If lfn 2 is on tape, the selected records are copied from the current file position; if 
lfn 2 is on mass storage, the copy starts at the current EOI of the file. If an EOF exists 
before the EOI, GTR appends the records as a file following the existing EOF. 

Examples: 

• GTR,SYSTEM,BIN,D.PP/* 

GTR copies all PP records from file SYSTEM to file BIN. It then builds a random 
access directory and writes it as the last record on BIN. 

• GTR,OPL,NEW,,NR.OPLC/COMCARG,0,COMCCIO 

GTR retrieves common decks COMCARG and COMCCIO from file OPL. It then writes 
COMCARG, a zero-length record, and COMCCIO at the current position of file NEW. 
NEW is not rewound before the operation; OPL and NEW are not rewound following the 
operation. 
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• GTR,SYSTEM,SYSLIB.D.ULIB/SYSLIB 

GTR copies the user library SYSLIB from file SYSTEM to the end of file SYSLIB. 

• GTR.REL/A 

GTR retrieves the relocatable record A from file OLD and copies it to file LGO. 

ITEMIZE COMMAND 

ITEMIZE lists pertinent information about each record of a binary file in a format suitable 
for printing. Earlier in this section. Library Record Type describes the types of records 
processed by ITEMIZE. 

ITEMIZE processes mass storage files or I or SI format tape files. A file can be processed 
from beginning-of-information through end-of-information. 

Format: 

ITEMIZE,lfn,L=listlfn,BL,PW=n,PD,NR,N=n,E,U. 

The first parameter is order—dependent; if Ifn is omitted, its position must be indicated by 
a comma. All the other parameters are optional and order-independent. 

Parameter Description 

Ifn Name of file to be itemized; default name is LGO. 

L=listlfn List output on file listlfn; default is L=0UTPUT. 

BL Burstable listing; each file output starts at the top of a page. 

Default is a compact listing in which a page eject occurs only when the 
current page is nearly full. 

PW=n Print either 136-character lines or 72-character lines, depending on the 

value of the decimal integer n. If n ^ 136, print 136-character line. 

If n < 136, print 72-character lines. 

If just PW is specified, print 72-character lines regardless of the 
listing file device. 

If PW=n is omitted, the default value is 72-character lines if the 
listing file is a terminal; otherwise, the default value is 
136-character lines. 

BD Print density at eight lines per inch; default is six lines per inch. 

If this parameter is to produce the desired result, you must ensure that 
output appears at a printer capable of eight lines per inch. 

NR No rewind of Ifn before or after processing; default is rewind before 

and after processing. 

N=n Itemize n files, where n is a decimal integer; default is N=l. 

If just N is specified, itemize until end-of-information. 

If N=0, itemize until an empty file is processed. 
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Parameter 


Description 


E Expand output to list further information; default is no expansion. 

For record types CAP and REL, list entry points. 

For types OPL and OPLC, list modification set names and their YANK 
status. 

For record types UPL, list correction identifier names. 

U Itemize all records within a user library; default is list only the 

user library directory {ULIB type record). 

If both E and U are selected for ULIB type records, all records in the library are itemized; 
and for REL type records, their entry points are listed. 

Output from ITEMIZE is affected by the type of record and parameters selected. A header 
appears for each file terminated by an end-of-flle marker within the file specified by the 
file name. The first line of the header identifies the file name, file position within that 
file, and the date and time of the run. It also includes the FI field if the file is a 
®ultifile set tape file (refer to the LABEL command). The second line of the header has the 
following fields: 


Field 

REC 

NAME 


Description 

Position of the record within the file. 

Record name obtained from the second word of the prefix table or from 
the first word of the record. 


type Type of record. Refer to Library Record Type, earlier in this 

section, for a description of the record types. 

LENGTH Number of words (octal) in the record, excluding the prefix table 

(except TEXT records for which the prefix table is included). 

CKSUM Logical checksum (octal), excluding the prefix table (except TEXT 

records for which the prefix table is Included). 


date Date record was created as stored in the prefix table. 

COMMENTS Contents of the comments field in the prefix table. 

If no prefix table is present, the associated fields are blank. 


INOTE I 

When printing output for text files, ITEMIZE 
uses the first seven characters of the first 
word of the record as the record name. 
ITEMIZE assumes that the record is in 6-bit 
display code. Therefore, if you attempt to 
display ITEMIZE output for a record in 
6/12-bit display code while your terminal is 
in ASCII mode, the output display may be 
garbled. To avoid this problem, you should 
set your terminal to NORMAL mode before 
listing ITEMIZE output. 
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Additional information listed depends on the type of record: 

Record Type Description 

ABS Enti^ point names are listed. 

OPL, OPLC, UPL Deck names are listed. 

OVL Overlay level is listed (octal). 

TEXT Entire record is listed if the name of the record is OVERLAY 

APRDxxx, CMRDxxx, EQPDxxx, IPRDxxx, LIBDxxx or COMMENT. 

6PP Lists the octal equivalent of the load address. 

7PP Lists the octal equivalent of the load address. 

The E parameter can select further details about several types of records (refer to the 
example that ends the ITEMIZE command description). 

The last record in each file is the end-of-file marker, which appears on the listing as the 
characters *EOF*. The SUM= identification is the total length, in words, for all records in 
the file, including the prefix table lengths. 

Any zero-length record in the file appears with the record name (00). When a zero-length 
record is encountered, a sum of the lengths of the records encountered since the beginning 
of the file, or since the last sum was taken, is listed on the output. The length includes 
prefix tables. Record numbering is not restarted until a new file is encountered. 

If a record of type UPL has more correction identifier names and/or deck names than can be 
accommodated within ITEMIZE, the following message appears on the listing in place of the 
excess names: 

TRUNCATED - REQUESTED LIST TOO LONG 

In this instance, the Update utility must be used to obtain a complete list of identifiers 
and deck names. 

A dayfile message is issued when ITEMIZE completes execution. 
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Example: 


A FORTRAN program named SUBROUT has three subroutines. The following ITEMIZE command lists 
the records of the binary object file LGO. The E option lists the entry point for each REL 
type record listed. 


/itemize,Lgo,e 



ITEMIZE OF 

LGO 

FILE 

1 


REC 

NAME 

TYPE 

LENGTH 

CKSUM 

DATE 

1 

SUBROUT 

REL 

SUBROUT 

105 

5355 

yy/mm/dd. 

2 

SUB1 

REL 

SUB1 

45 

0263 

yy/mm/dd. 

3 

SUB2 

REL 

SUB2 

45 

3276 

yy/mtn/dd. 

4 

SUB3 

REL 

SUBS 

45 

1542 

■yy/mm/dd. 


* EOI * SUM = 26A 

ITEMIZE COMPLETE. 


LIBEDIT COMMAND 

LIBEDIT is a general-purpose utility that generates a file containing records copied from 
one or more other files (figure 15-2). LIBEDIT can build a random access directory for the 
new file. It recognizes the record types listed in Library Record Types in this section. 
LIBEDIT can edit a library according to directives requesting addition, deletion, or 
replacement of specified records from one or more replacement files. 

LIBEDIT executes in two phases. During the first phase, it reads directives and replacement 
records. It groups directives by type and file and groups changes when several insertions 
take place relative to the same record. 

During the second phase, LIBEDIT writes the new file. If LIBEDIT cannot process the 
specified combination of directives, and debug mode was not specified (refer to the 
description of the D parameter under Command Format), LIBEDIT lists its interpretation of 
the conflicting directives. Issues an error message, and aborts the job step. If debug mode 
was specified, LIBEDIT continues processing the directives. 

For output listing files not connected to your terminal, the LIBEDIT command honors the page 
length and print density set for your job using the SET command and the PL and PD symbolic 
names. 
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Figure 15-2. LIBEDIT Input and Output 


COMMAND FORMAT 

The following command calls LIBEDIT. Its parameters specify options and files used for the 
call as Illustrated in figure 15-2. 

Format: 


LIBEDIT,PI,p2,...,pn. 


Optional parameters pj^ can be in any order. Each parameter cannot be specified more than 
once. 


Pi Description 


B“lfn 4 Use records from file lfn 4 for insertions and replacements. The 

defaxilt is LGO. B=0 indicates that there is no replacement file. 

C Copy the new file over the old file after LIBEDIT processing. 

D Do not abort LIBEDIT processing because of errors. (This parameter is 

referred to as debug mode.) 

l-lfn 3 Take the new directives from the next record of file lfn 3 . The 

default is INPUT (INPUT is connected to the terminal in interactive 
jobs). l^O indicates that there are no directives. 

L-lfns List output on file Ifns. The default is OUTPUT. L»0 specifies no 

output. 
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El 

LO=listopt 


NA 

NI 

NR 

NX=n 

N-lfn2 

P==lfni 


U=record 


V 


Description 


Use list option listopt. 


listopt 


Meaning 


C List directives. 

E List errors. 

F Give a full listing (enable all list options). 

M List modifications. 

N List records written to new file. 


You can combine the list options. For example, LO=CM or LO=CE. 

The default is LO=EM for interactive jobs, and LO=F for all other jobs. 

Do not abort on directive errors. 

Do not Insert unreplaceable records at EOF of the new file. 

Do not rewind the old or new file before or after LIBEDIT processing. 

By default, the system rewinds the old file and new file. 

Include cross-references in the library directory of the new user 
library if n is 0. If n is nonzero, do not include cross-references. 
This parameter is meaningful only if you specify the U parameter or 
the *LIBGEN directive. The default is NX=0. 

Write the new file on lfn2. The default is NEW. 

Edit old file Ifnj. The default is OLD. P=0 directs the system to 
create the new file from replacement files. 


NOTE 


Although LIBEDIT can write the new file (lfn2) 
directly to tape, the directory that LIBEDIT 
writes on such a tape contains tape PRU random 
addresses rather than disk PRU random 
addresses. If this tape is subsequently 
copied to disk, the directory will not be 
processed correctly by programs such as GTR 
and Modify. Therefore, if you Intend to copy 
the file back to disk at a later time, you 
should specify a temporary disk file for the 
LIBEDIT new file (lfn2) and then use the COPY 
utility to copy the new file to tape. 

Require the old file to be a user library, add any new records from 
the replacement file to the new file, and make the new file a user 
library by calling LIBGEN. This parameter overrides the V parameter. 
The value record becomes the name of the ixser library directory 
record. If you specify only the keyword U or omit the parameter 
entirely, the default record name is ULIB. 

Verify the new file against the old file after LIBEDIT processing by 
calling VFYLIB. The default is no call to VFYLIB. The U parameter 
overrides this parameter. 
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Pi 


Description 


Z Take the directives from the command line. The directives immediately 

follow the command terminator. The first character following the 
terminator is the separator character used to separate the directives 
in the sequence. It can be any character not used in the directives. 
For example: 

LIBEDIT,2.#*DELETe"rEL/PR0G1#*ADD PR0G2 
The Z parameter overrides the I=lfn 3 . 

LIBEDIT DIRECTIVES 

You can specify directives to control LIBEDIT processing. These directives can be in a 
record on file INPUT (terminal input for interactive jobs), can be on the file specified by 
l“lfn 3 parameter of the command, or can follow the terminator of the command when the Z 
parameter is specified. Directives are not required. 

Unless specified otherwise by parameters or directives, LIBEDIT compares the name and type 
of each record on the old file with those of the records on the replacement file (specified 
by the B parameter). If a record with the same name and type appears on the replacement 
file, LIBEDIT writes that record on the new file and skips the record on the old file unless 
you specified the *NOREP directive. If 1=0 and B=0 are specified, LIBEDIT copies the old 
file to the new file until it encounters an EOF mark or an OPLD directory on the old file. 

Records on a replacement file which do not appear on the old file with the same name and 
type are considered unreplaceable. Such records are inserted at EOF of the new file, unless 
the NI parameter or *N0INS directive is specified. If a record with the same name or type 
appears on more than one replacement file or appears more than one on a replacement file, 
the extra copies are treated as unreplaceable records. 

LIBEDIT processing of user libraries beginning with a ULIB record differs depending on 
whether or not the LIBGEN directive is specified. If no LIBGEN directive is specified, the 
user library is processed as one record (from ULIB header to OPLD). In this case, the only 
part of the user library that can be manipulated by LIBEDIT is the ULIB header. The records 
within the user library are transparent to LIBEDIT and cannot be referenced by directives. 

If the LIBGEN directive is specified, LIBEDIT deletes the ULIB header and OPLD records from 
all user libraries encountered. In this case, LIBEDIT directives can reference any records 
within the user library but cannot reference the ULIB header. 

LIBEDIT directives take precedence over the parameters of the command when conflicting 
specifications occur. 
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LIBEDIT recognizes the following directives 


Directive 

*ADD 

*BEFORE or *B 

*BUILD 

*C(»!MENT 

*COPY 

*DATE 

*DELETE or *D 

*FILE 

*IGNORE 

*INSERX or *I or *AFTER or *A 

*L1BGEN 

*LIST 

*NEW 

*NOINS 

*NOREP 

*NOREW 

*OLD 

*RENAME 

*REPLACE 

*REWIND 

*TyPE or *NAME 

*VFYLIB 

*/ 


Function 

Inserts records before a zero-length record within the 
file. 

Inserts .record before the named record. 

Builds a directory at the end of the new file. 

Adds a comment to the prefix table. 

Copies the new file to the old at the end of editing. 

Adds the date and a comment to the prefix table. 

Does not copy specified records to the new file. 

Declares a file to be a replacement file. 

Ignores records when reading the replacement file. 

Copies record from the replacement file after copying 
the specified old file record. 

Generates a user library by calling LIBGEN after 
LIBEDIT processing. 

Specifies a list file and list options. 

Specifies a new file. 

Prevents the insertion of unreplaceable records at EOF 
of the new file. 

Does not automatically replace old file records with 
records from the specified file. 

Prevents the old file and the new file from being 
rewound before and after LIBEDIT processing. 

Specifies an old file. 

Renames record. 

Replaces the named records from the old file with 
records from the replacement file. 

Names file to be rewound before and after editing. 

Sets default record type. 

Verifies the new file against the old file by calling 
VFYLIB after LIBEDIT processing (overridden by *LIBGEN). 

Specifies a directive file comment. 
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A directive begins with an asterisk in column 1 followed immediately by the directive 
identifier. The directive identifier and the first parameter are both delimited by a comma 
or one or more spaces. If a directive does not begin with an asterisk and a directive 
identifier, LIBEOZT assiomes that the operation is a continuation of the previous directive 
operation. If an asterisk and directive identifier do not begin the first line of the 
directives record, LIBEDIT prefixes the following to the first line. 

*BEFORE,*, 

Parameters other than the first parameter are delimited by a space, an end-of-line, or a 
comma. A hyphen (-) indicates a record group. Record group identifiers (gid entries) 
cannot be split between lines. For example, the lines 

*B,0VL/P1,0VL/P2,OVL/ 

P3 

do not constitute a valid directive. The last entry would not be processed as 0VL/P3. On 
the other hand, the lines 

*B,0VL/P1,0VL/P2 

0VL/P3 

do constitute a valid directive and would be processed as 
*B,0VL/P1,OVL/P2,OVL/P3 

Parameters common to many directives are the reference record identifier (rid) and the 
record group identifier (gid). Valid record types for these parameters are listed in 
Library Record Types in this section. The default type is the last type specified in a 
directive; if none are specified, TEXT is the default. The record name is the first seven 
characters of the record, or if a prefix table is present, the name in its second word. The 
first character of a record name specified in a directive must not be an asterisk. 

rid Reference record identifier specifying the reference point for the requested 
change. It can have the following formats. 

Parameter Description 

type/name Reference record has the specified type and name. 

name Reference record has the specified name and is of 

the default type. 

* Reference point is an end-of-file mark (used with 

*BEFOR£ directive only). 

gid Record group identifier indicating a record or group of records to be inserted, 
deleted, or replaced. It can have the following formats. 

Parameter Description 

type/name Record with the specified type and name. 

name Record with the specified name of the default type. 

typej^/name^-type 2 /name 2 Group of records beginning with name][ of typej^ 

and ending with name 2 of type 2 . 
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Parameter 

Description 

t yp e 1 /namei-name 2 

Group of records beginning with namei of typei 
and ending with name 2 of typex. 

name]^-name2 

Group of records beginning with namex of the 
default type and ending with name 2 of the 
default type. 

type/name-* 

All records of the specified type beginning with 
the named record. 

name-* 

All records of the default type beginning with the 
named record. 

type/* 

All records of the specified type. 

:k 

All records of the default type. 


0 A zero-length record is Inserted. 


LIBEDIT checks the syntax of directives during an interactive session and 
reprompts you for a directive in error. 
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ADD Directive 


The ADD directive inserts records before a zero-length record. A CATALOG listing of the old 
file numbers each group of records ending with a zero-length record (called a library on the 
listing). This number on the ADD directive identifies the record group. 


NOTE 


Adding a zero-length record does not change 
the directory. 


Format: 

*ADD LIBn,gidj,gid 2 ,...,gidjj 


Parameter Description 


LIBn Specifies the record group to which the records are appended. Values 

for n are 1 to 9999 and can be determined from a CATALOG listing of 
the old file. 


gid£ Identifies the records or groups of records from the current 

replacement file that are to be inserted before the zero-length record. 


Example: 


The following is a CATALOG listing of file Q. 


REC 

CATALOG 

NAME 

OF Q 

TYPE 

FILE 

LENGTH 

CKSUM 

DATE 

1 

REC1 

TEXT 

1 

5302 


2 

REC 2 

TEXT 

1 

5304 


3 

(00) 

SUM * 

2 

LIBRARY = 

1 

4 

REC 4 

TEXT 

1 

5310 



* EOI * 

SUM = 

3 




The following output results when a record was added to file Q, producing file Y. 


LlBEDir DIRECTIVE CAROS. 


yy/mm/dd. 15.12.51. PAGE 1 


*ADD LIB1,REC3 
RECORDS WRHTEN ON FILE Y 


RECORD 

TYPE 

FILE DATE 

REC1 

TEXT 

Q 

REC 2 

TEXT 

Q 

INSERTED REC3 

TEXT 

X 

00 


Q 

REC4 

TEXT 

Q 

**E0F** 


Q 


yy/mtn/dd. 15.12.51. PAGE 2 

COMMENT 
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BEFORE Directive 


A BEFORE directive Inserts records or groups of records before a specified reference record 
on the old file. An old file record with the same name and type as an inserted record is 
not copied to the new file. 

Formats: 

*BEFOEE rid,gidi,gid2.gid^ 

or 


*B rid,gidi^gld2.gidn 

Parameter Description 

rid Names the old file record before which the specified replacement file 

records are to be inserted. 

S^^i Identifies records or groups of records from the current replacement 

file that are to be inserted before the reference record (rid). 

If the first line of the LIBEDIT directives record does not begin with an asterisk and 
directive name, LIBEDIT assumes that the line is the gid parameters following a *BEFORE*, 
directive. 


BUILD Directive 

A BUILD directive constructs and appends a random access directory to the new file. The 
directory is in Modify format (an OPLD record). If the old file has an OPLD directory, 
LIBEDIT constructs a directory for the new file with or without a BUILD directive. BUILD 
can also be used to change the directory name. 

Format: 

*BUILD dname 

dname Specifies the name for the directory record. The name must be one to 

seven alphanumeric characters. No default. 
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COMMENT Directive 


The COMMENT directive adds a comment to the prefix (77) table of a record written on the new 
file. 

Format: 

*COMMENT rid comment 

Parameter Description 


rid Name of a record to be written on the new file. 

comment A string of up to 70 characters that appears in the comment field of 

the prefix table. Additional characters are truncated. 


COPY Directive 

The COPY directive directs LIBEDIT to copy the new file over the old file after it has 
processed all directives. It performs the same function as the C parameter on the LIBEDIT 
command. This directive has no parameters. 


DATE Dir^ive 

The DATE directive adds the current date and the specified comment to the prefix (77) table 
of a record written on the new file. 

Format: 

*DATE rid comment 


Parameter Description 

rid Record to be written on the new file. 


comment 


A string of up to 70 characters to be written in the comment field of 
the prefix table. Additional characters are truncated. 
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DB£TE Directive 


The DELETE directive suppresses copying of the specified records from the old file to the 
new file. 

Formats; 

*DELETE 8i<ii,gid2.....gidn 


or 


*D si'll,gid 2 ,...,gidn 


gi<li 


Identifies records or groups of records that are not to be copied from 
the old file to the new file. 


Example: 

*DELETE OVL/LAD-REL/RUN 

This directive requests LIBEDIT not to copy the sequence of records starting with overlay 
LAD through relocatable CPU program RUN. 


RLE Directive 

The FILE directive names a file assigned to the job that contains replacement records. 
LIBEDIT directives following the FILE directive refer to records on the declared replacement 
file. 

Format: 

*FILE Ifn 

Ifn Specifies the name of a relacement file. If Ifn is an asterisk (*), 

LIBEDIT uses the replacement file specified by the LIBEDIT command. 

If the B parameter was omitted from the command, LGO is used. 
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IGNORE Directive 


The IGNORE directive requests LIBEDIT to ignore a record or group of records on the current 
replacement file. 

Format: 

*IGNORE gldi,gid2,...,gidn 

Parameter Description 

gidi Identifies records or groups of records on the replacement file that are 

to be ignored. 


Example: 

♦FILE ALPHA 
♦IGNORE C-^ 

LIBEDIT ignores the sequence of records on file ALPHA starting with record C of the default 
type and Including all records of the default type from C to the EOF mark. 


INSERT or AFTER Directive 

The INSERT or AFTER directive requests LIBEDIT to copy the specified records or groups of 
records from the current replacement file after it has copied the specified old file record 
onto the new file. Any record on the old file that has the same name and type as an 
inserted record is not copied to the new file. 

Formats: 

♦INSERT rid,gidi,gid2,...,gidn 
or 

♦I rid,gidi,gid2,...,gidn 
♦AFTER rid,gidi,gid2,...,gidn 
or 

^1(1 »Sid j jgid2f... .gid 

Parameter Description 

rid Names the old file record to be written on the new file. 

gid Identifies records or groups of records on the replacement file that are 

to be copied. 


Example: 

♦INSERT OPL/K,TEXT/L 

This directive requests LIBEDIT to copy the replacement file TEXT record L to the new file 
after it has copied the old file OPL record K. 
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UBGEN Directive 


The LIBGEN directive specifies that the new file will be a user library. The U parameter of 
the LIBEDIT command performs the same function. The LIBGEN directive overrides the VFYLIB 
directive. 

Format; 

*LIBGEN recordname 

Parameter Description 


recordname Specifies the name of the new user library directory record. The 
default is ULIB. 


LIST Directive 

The LIST directive changes the list file and the list option (refer to the L=lfn 5 and 
LO=listopt parameters of the LIBEDIT command described earlier). 

Format: 

*LIST listfile,listopt 

Parameter Description 

listfile Specifies the list file, 

listopt Specifies the list option. 

NEW Directive 

The NEW directive specifies the name of the new file. The N=lfn 2 parameter of the LIBEDIT 
command performs the same function. 

Format: 

*NEW newflle 

Parameter Description 

newfile Specifies the name of the new file. 


NOINS Directive 

The NOINS directive prevents the insertion of unreplaceable records at EOF of the new file. 
The NI parameter of the LIBEDIT command performs the same function. This directive has no 
parameters. 

Format: 

*NOINS 
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NOREP Directive 

The NOREP directive declares the specified files to be no-replace files. A no-replace file 
is a replacement file whose records do not automatically replace old file records having the 
same name and type. The user selects records to be written on the new file from no-replace 
files by specifying the file on a FILE directive and then naming the records on *AFTER, 
*BEFORE, *INSERT, and *REPLACE directives. 

Format: 

*NOREP lfnj,lfn2,...,lfnn 

Parameter Description 


Specifies the no-replace files. 


NOREW Directive 

The NOREW directive prevents the old file and new file from being rewound before and after 
LIBEDIT processing. The NR parameter of the LXBEDIT command performs the same function. 
This directive has no parameters. 

Format: 

*NOREW 


OLD Directive 

The OLD directive specifies the name of the old file. The P=lfni parameter of the LIBEDIT 
command performs the same function. 

Format: 

*OLD oldfile 

Parameter Description 

oldfile Specifies the name of the old file. 


RENAME Directive 

The RENAME directive assigns a new name to a record written on the new file. If the renamed 
record is referenced by another directive in the directive record, the old name should be 
used. A RENAME is not allowed on a PROC or TEXT type record. 

Format: 

*RENAME rid,name 

P arameter Description 


rid Specifies the name of the replacement file record or old file record 

to be renamed. 

name Specifies the name of the record. The name can be one to seven 

alphaninneric characters. 
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RB*LACE Directive 


The REPLACE directive requests LIBEDIT to replace the old file records having the specified 
names and types with the replacement file records having matching names and types. This 
directive is used when the current replacement file has been declared a no-replace file 
(refer to the NOREP directive description). If the replacement file is not a no-replace 
file, LIBEDIT performs the replace operation automatically. 

Format: 

*REPLACE gidi,gid2,...,gidn 

Parameter Description 


gidj_ Specifies records or groups of records that appear on both the old 

file and the current replacement file. 


Example: 

The old file contains text records A, B, C, and D; the replacement file RF also contains 
text records named A, B, C, and D. Either of the following directive sequences writes 
records A and B from the old file and records C and D from file RF onto the new file. 

Sequence 1 Sequence 2 

*FILE RF *F1LE RF 

*NOREP RF *IGNORE A-B 

*REPLACE C-D 

REWIND Directive 

The REWIND directive tells LIBEDIT to rewind the specified file before and after processing. 
Format: 

*REWIND Ifn 


Parameter 


Description 


Ifn Specifies the name of the file to be rewound. 


TYPE or NAME Directive 

A TYPE or NAME directive sets the default record type. 

Formats: 

*TYPE type 
*NAME type 

Parameter Description 


type Specifies default record types. Valid record types are listed in 

Library Record Types in this section. 
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The default record type can also be set by an explicit record type specification within a 
directive. In either case, the default record type setting remains in effect until another 
record type is explicitly named. If a default record type is not declared in the directive 
sequence, the default is TEXT. For example, the following two directive sequences are 
equivalent. 

Sequence 1 Sequence 2 

*TYPE REL *INSERT REL/X,Y 

*1NSERT X,y *DELETE FILE1-FILE4 

*DELETE FILE1-FIEE4 


VFYUB Directive 

The VFYLIB directive verifies the new file against the old file by calling VFYLIB after 
LIBEDIT processing. The V parameter of the LIBEDIT command performs the same function. 

This directive has no parameters. The LIBGEN directive or U parameter overrides the VFYLIB 
directive. 

Format: 

*VFYLIB 


*/Directive (Comment Directive) 

The */ directive allows comments to be inserted into the LIBEDIT directive file. 

Format: 

*/ text 

Earameter De&cription 

text Specifies the comments (up to 80 characters in length) that are 

copied to the list file. 


UBEDIT OUTPUT 

LIBEDIT Interprets all directives in the directive record before beginning directive 
processing. If one or more errors are found, LIBEDIT issues the dayfile message 

n DIRECTIVE ERROR(S). 

and aborts the job step (unless the D parameter is specified on the command or the job is 
Interactive). The following LIBEDIT output shows the results of a directive syntax error 
(the FILE directive is not followed by a space or comma). 

DIRECTIVE ERRORS. yy/mm/dd. hh.mm.ss. PAGE 1 

★ERROR* *FILERF1 

Directives which cannot be executed are listed as LIBEDIT interpreted them. The following 
LIBEDIT run called for a replacement file not assigned to the job. 

DIRECTIVE ERRORS. yy/mm/dd. hh.mm.ss. PAGE 1 

★FILE RF1 
★B 

★ERROR* DIRECTIVE CARD CAN NOT BE PERFORMED 
★FILE RF1 
★BEFORE TEXT/*,TEXT/X 
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Nonfatal errors are listed in an error directory following the listing of records written to 
the new file. The RECORDS NOT REPLACED error shown in the following example could be 
corrected by including an *IGNORE directive naming the records not to be replaced. 

DIRECTIVE ERRORS. yy/mtn/dd. hh.mm.ss. PAGE 1 

★FILER F2 
*B *,REC1 

RECORDS WRITTEN ON FILE NEW yy/mm/dd. hh.mm.ss. PAGE 2 

RECORD TYPE FILE DATE COMMENT 

INSERTED REC 1 TEXT RF2 

**E0F** OLD 

ERROR DIRECTORY - RECORDS NOT REPLACED. yy/mm/dd. hh.mm.ss. PAGE 3 

RECORD TYPE FILE 

REC3 TEXT RF2 

RECA TEXT RF2 

If you are using LIBEDIT from an interactive job, the BRIEF command suppresses the printing 
of title lines on the output. 

LIBGEN COMMAND 

The LIBGEN command generates a user library of routines for use with the CYBER Loader. 

Format; 

LIBGEN,... 

Any of the following parameters may be.specified in any order (only one Instance of each). 

Description 

F=lfni Specifies the source file containing absolute (ABS), overlay (OVL), 

procedure (PROG), relocatable (REL), or capsule (CAP) records for the 
user library. Other record types are ignored. If the file F does not 
contain any of the record types specified, no library is generated. 

The default for this parameter is LGO. 

N=name Specifies the name of the user library generated, name is entered in 

ULIB and OPLD records. The default is the user library name 
determined by the P=lfn 2 parameter. 

NX=n Specifies whether or not to include cross-references in the ULIB 

directory. If n is not zero, no cross-references are Included in the 
ULIB directory. If n is zero, cross-references are included. The 
latter case is the default. 

P=lfn 2 Specifies the file on which the user library is to be written. The 

default is ULIB. 
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If the F-lfn^ and P=lfn2 parameters specify the same file, LIBGEN issues a dayfile 
message and does not generate a user library. 

Figure 15-3 illustrates the structure of a user library. To generate a user library, the 
system rewinds and scans the input file. It then builds a directory of all entry points, 
program names, and external references in the records of the file. Adding the ULIB and OPLD 
records, the system then copies the input file to the user library file. 


ULIB 


User library directory 

REL 



REL 


’ Relocatable routines 

REL 



OPLD 


Raitdom access directory 


Figure 15-3. User Library Structure 


Unless the NX=n parameter specifies otherwise, the ULIB directory contains the external 
reference/entry point linkage between routines in the user library. When the CYBER Loader 
loads a routine from the user library, it loads (at the same time) all user library routines 
referenced by the requested routine. All externals for user library routines are satisfied 
from the user library, if possible. If desired, you can request with the NX“n parameter 
that the ULIB directory contains no cross-linking of records. In that case, when a routine 
from the user library is requested, only that routine is loaded. Loading in this manner is 
typically slower than using the cross-reference linkage option. 


Example 1: 

File RELB contains relocatable routines that are tised for execution of several 
applications. To enable loading of these routines as needed during execution of an 
application program, the user generates a user library using the following command. 

LIBGEN,F=RELB,P=MYLIB,N=APPLIB. 

This creates user library APPLIB on file HYLIB. The following loader sequence allows use of 
the APPLIB routines during execution of a compiled FORTRAN 5 program on file LGO. 

LDSET,LIB=MYLIB. 

L0AD,L60. 

EXECUTE. 

The program is loaded and executed with externals satisfied first from user library MYLIB 
and then from the system default library SYSLIB. Refer to the CYBER Loader Reference Manual 
for more information on library search procedures. 
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Example 2: 


If a routine has no external references, no entry is made in the ULIB directory. To load 
this routine, you must include the loader command LDSEX(USEP=pname} in a loader sequence. 

Suppose a FORTRAN 5 contains a BLOCK DATA subroutine without external references to any of 
its entry points. The user has not named the block, and it has the default name BLKDAT. To 
load this routine, you must include the following command in the loader sequence. 

LDSET,USEP=$BLKDAT.$. 


ULIB COMMAND 


The ULIB command creates a user library or adds a record to, deletes a record from, or 
replaces a record in an existing user library. ULIB changes affect only the local copy of a 
user library. You can use the SAVE or REPLACE command, or copy the new library file to a 
direct access permanent file, to make the user library file permanent. 

Format: 

ULIB, OP=oi>eration ,REC=record, LIB=library. 
or 

ULIB,operation,record,library. 

All parameters are required. The first format is the order-independent format for the 
parameters. The second is the order-dependent format. 


Parameter 


Description 


OP=operation Specifies the library operation to be done. You can specify one of 
the following values: 


Operation 

A 

C 

D 

F 


Description 

Add a record to the user library (same as R). 

Create a new user library. 

Delete a record from the user library. 

Copy a record from the user library and make the 
copy a local file with the same name as the record. 


R Replace a record in the user library (same as A). 

REC=record Specifies the name of the record to be added, deleted, replaced, or 
copied. The record name must be the name of a local file. 


LIB“library Specifies the name of the local library file to be created or 

modified. Except in the case of OP«C or 0P=F, ULIB returns the 
original library file and creates a new local file. Hence, ULIB 
cannot be used to directly modify a library on a direct access file. 
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The ULIB conanand is an interactive procedure. You can get help information for the command 
and its parameters and be prompted for parameters. If you enter 

ULIB? 

the system gives you information about the command itself and prompts you for parameters. 

If you enter 

ULIB,parameter? 

the system gives you information about the specified parameter and prompts you for 
parameters. 


VFYLIB COMMAND 

The VFYLIB command rewinds two files, compares their records, and lists the differences. 
VFYLIB does not perform a bit-by-bit comparison of the two files. It only compares such 
entries as name, type, length, and checksum for the records of the two files. For a binary 
comparison of two f iles , use the VERIFY command. For output listing files not connected to 
your terminal, the VFYLIB command honors the page length and print density set for your job 
using the SET command and the PL and PD symbolic names. 

Format; 


VFYLIB,Ifni,ifn 2 ,If 03 ,NR. 


Parameter 

Ifnf 

lfn2 

Ifna 


Description 


Name of the first file; if this parameter is omitted, VFYLIB assumes 
file OLD. 


Name of the second file; if this parameter is omitted, VFYLIB assumes 
file NEW. 


Name of the output file; if this parameter is omitted, VFYLIB assumes 
file OUTPUT. 


NR If specified, Ifni lfn2 are not rewound after verification. 

The record types that VFYLIB recoglzes are listed in Library Record Types in this section. 
VFYLIB lists changes in residence (between record groups separated by zero-length records), 
replacements, deletions, and insertions. A record is defined as being replaced when its 
name and type remain the same, but its contents differ. VFYLIB does not compare prefix (77) 
table information such as last modification date and last assembly date. VFYLIB does not 
consider a difference in record order as a difference between the two files. 


NOTE I 


When printing output for text files, VFYLIB 
uses the first seven characters of the first 
word of the record as the record name. VFYLIB 
assumes that the record is in 6 -bit display 
code. Therefore, if you attempt to display 
VFYLIB output for a record in 6/12-blt display 
code while your terminal is in ASCII mode, 
the output display may be garbled. To avoid 
this problem, you should set your terminal to 
NORMAL mode before listing VFYLIB output. 
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Example: 

The following are CATALOG listings of file OLD and file NEW. 



CATALOG 

OF OLD 

FILE 

1 


REC 

NAME 

TYPE 

LENGTH 

CKSUM 

DATE 

1 

A 

REL 

41 

7424 

yy/mm/dd. 


A 





2 

(00) 

SUM 

= 41 

LIBRARY 

= 1 

3 

B 

REL 

41 

0465 

yy/mm/dd. 


B 





4 

C 

REL 

41 

5525 

yy/mm/dd. 


C 





5 

* EOF * 

SUM 

= 143 



CATALOG 

COMPLETE. 






CATALOG 

OF NEW 

FILE 

1 


REC 

NAME 

TYPE 

LENGTH 

CKSUM 

DATE 

1 

A 

REL 

41 

7424 

yy/mm/dd. 


A 





2 

B 

REL 

41 

0465 

yy/mm/dd. 


B 





3 

(00) 

SUM 

= 102 

LIBRARY 

= 1 

4 

D 

TEXT 

1 

1000 


5 

* EOF * 

SUM 

= 103 



CATALOG 

COMPLETE. 





VFYLIB. 

OLD FILE : 

= OLD NEW 

FILE = 1 

NEW yy/mm/dd. hh.mm.ss. 

1 

RECORD 

TYPE 

ULIB 

LIB 

DATE COMMENT 


CHANGES IN RESIDENCE. 

B REL 

DELETED RECORDS. 

C REL 

INSERTED RECORDS. 

D TEXT 


1 yy/mm/dd. SUBROUTINE0PT=0 


yy/mm/dd. SUBROUTINE0PT=0 


PAGE 1 
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UBRARY PROCESSING EXAMPLES 


The following examples illustrate the use of CATALOG, LIBEDIT, and LIBGEN commands. To 
duplicate the examples, you should execute the jobs in sequence. 

Example 1: 

The following submit job builds a program library from a replacement file of relocatable 
binary (REL) records. 

/JOB 
LIBTES1. 

/USER 

FTN5,L=0. 

DEFINE,TESTLIB. 

CATAL06,LG0,R. 

LIBEDIT,P=0,N=TESTLIB. 

CATAL06,TESTLIB,R. 

/EOR 

SUBROUTINE A 

STOP 

END 

SUBROUTINE D 

STOP 

END 

SUBROUTINE C 

STOP 

END 

SUBROUTINE B 

STOP 

END 

/EOR 

★BUILD LIBRARY 

*B,*,REL/A,B,C,0 

/EOF 


The FORTRAN compilation produces relocatable binaries on the default file LGO. The DEFINE 
command creates a direct access permanent file TESTLIB on which the new program library is 


written. 

The first 

CATALOG 

command lists 

the LGO 

file as follows: 




CATALOG OF LGO 

FILE 

1 

yy/tnm/dd 

. hh.mm.ss. PAGE 

1 

REC 

NAME 

TYPE 

LENGTH 

CKSUM 

DATE 

COMMENTS 



1 

A 

A 

REL 

41 

7424 

yy/mm/dd. 

SUBROUTINE0PT=O,ROUND= 

A/ 

S/ 

2 

n 

D 

IN 

REL 

41 

6566 

yy/mra/dd. 

SUBR0UTINE0PT=0,ROUND= 

A/ 

s/ 

3 

1/ 

C 

r 

REL 

41 

5525 

yy/mm/dd. 

SUBR0UTINE0PT=0,R0UND= 

A/ 

s/ 

4 

B 

B 

REL 

41 

0465 

yy/mm/dd. 

SUBR0UTINE0PT=0,R0UND= 

A/ 

s/ 

5 

* EOF * 

SUM 

= 204 







The P=0 in the LIBEDIT command indicates that no old program library exists. The N parameter 
indicates that the new program library is written on file TESTLIB. The replacement file is 
the default LGO. The directives are on the default INPUT file. 
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LIBEDIT reads the binaries from LGO and the directives from INPUT. On the basis of the 
directive specifications, the binaries are inserted before the end-of-file on file TESTLIB 
in the order specified in the directives (A, B, C, D). The directory record created is 
given the name LIBRARY as a result of the *BUILD directive. It is written before the 
end-of-file on the new program library TESTLIB. 

The directives are written to OUTPUT. The records -on file TESTLIB are listed on the next 
page of OUTPUT. The following listing consists of these two pages. 

LIBEDIT DIRECTIVES. yy/mm/dd. hh.mm.ss. PAGE 1 


★BUILD LIBRARY 
*B,*,REL/A,B,C,D 


RECORDS WRITTEN ON FILE TESTLIB yy/mm/dd. hh.mm.ss. PAGE 2 



RECORD 

TYPE 

FILE 

DATE COMMENT 

INSERTED 

A 

REL 

LGO 

yy/mm/dd. SUBROUTINE0PT=0 

INSERTED 

B 

REL 

LGO 

yy/mm/dd. SUBR0UTINE0PT=0 

INSERTED 

C 

REL 

LGO 

yy/mm/dd. SUBROUTINE0PT=0 

INSERTED 

D 

REL 

LGO 

yy/mm/dd. SUBR0UTINE0PT=0 

ADDED 

LIBRARY 

OPLD 

***** 

yy/mm/dd. 


**E0F** 


The second CATALOG command produces the following listing of information about the records 
on TESTLIB. 


CATALOG OF TESTLIB FILE 1 yy/mm/dd. hh.mm.ss. PAGE 1 


REC 

NAME 

TYPE 

LENGTH 

CKSUM 

1 

A 

A 

REL 

41 

7424 

2 

B 

B 

REL 

41 

0465 

3 

C 

C 

REL 

41 

5525 

4 

D 

D 

REL 

41 

6566 

5 

LIBRARY 

OPLD 

13 

2073 


6 * EOF ★ SUM = 217 


DATE COMMENTS 

yy/mm/dd. SUBR0UT1NE0PT=0,R0UND= A/ S/ M 
yy/mm/dd. SUBROUTINEOPT=0,ROUND= A/ S/ M 
yy/mm/dd. SUBR0UTINE0PT=0,R0UND= A/ S/ M 
yy/mm/dd. SUBR0UT1NE0PT=0,R0UND= A/ S/ M 
yy/mm/dd. 
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Example 2: 


This submit job builds a new program library from an old program library by inserting new 
relocatable routines into and deleting routines from the old program library created in 
example 1 (TESTLIB). 

/JOB 

LIBTES2. 

/USER 

FTN5,L=0. 

ATTACH,OLD=TESTLIB. 

DEFINE,NEW=TES2LIB. 

LIBEDIT. 

CATALOG,NEW,R. 

/EOR 

SUBROUTINE BONE 

STOP 

END 

SUBROUTINE NEWC 

STOP 

END 

SUBROUTINE D 

STOP 

END 

/EOR 

♦TYPE REL 
*I,B,BONE 
*D,C 
/EOF 

Three relocatable binaries (BONE, D, and NEWC) are produced via a FORTRAN compilation. The 
old program library (TESTLIB) is attached in read mode and referenced as OLD. A direct ac¬ 
cess file (TES2LIB) is created for the new program library. This file is referenced as NEW. 

LIBEDIT reads the binaries from the replacement file LGO and the input directives from file 
INPUT. It writes the modified old program library (OLD) to the new program library (NEW). 
BONE and NEWC are inserted after records B and C, respectively, and record C is deleted. 
Record D, which already existed on the old program library, is replaced by record D from the 
replacement file LGO. The following action is taken on file NEW. 

LIBEDIT DIRECTIVES. yy/mm/dd. hh.mm.ss. PAGE 1 


♦TYPE REL 
♦I,B,BONE 
♦ D,C 


RECORDS WRITTEN ON FILE NEW yy/mm/dd. hh.mm.ss. PAGE 2 



RECORD 

TYPE 

FILE 

DATE COMMENT 





A 

REL 

OLD 

yy/mm/dd. SUBROUTINEOPT=0,ROUND= 

A/ 

S/ 

M 


B 

REL 

OLD 

yy/mm/dd. SUBROUTINEOPT=0,ROUND= 

A/ 

S/ 

M 

INSERTED 

BONE 

REL 

LGO 

yy/mm/dd. SUBROUTINEOPT=0,ROUND= 

A/ 

S/ 

M 

DELETED- 

(C) 

REL 

OLD 





REPLACED 

D 

REL 

LGO 

yy/mm/dd. SUBROUTINEOPT=0,ROUND= 

A/ 

S/ 

M 

ADDED 

NEWC 

REL 

LGO 

yy/mm/dd. SUBROUTINEOPT=0,R0UND= 

A/ 

S/ 

M 

ADDED 

LIBRARY 

OPLD 

***** 

yy/mm/dd. 





♦♦EOF^^ 


OLD 
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The CATALOG output shows the following contents of the new program library. 

CATALOG OF NEW FILE 1 yy/mra/dd. hh.mm.ss. PAGE 1 


REC 

NAME 

TYPE 

LENGTH 

CKSUM 

DATE COMMENTS 




1 

A 

A 

REL 

41 

7424 

yy/mm/dd. SUBROUTINEOPT=0,ROUND= 

A/ 

S/ 

M 

2 

A 

B 

B 

BONE 

REL 

41 

0465 

yy/mm/dd. SUBROUTINEOPT=0,ROUND= 

A/ 

S/ 

M 

3 

REL 

41 

4312 

yy/mm/dd. SUBROUTINEOPT=0,ROUND= 

A/ 

S/ 

M 


BONE 








4 

D 

REL 

41 

6566 

yy/mm/dd. SUBROUTINEOPT=0,ROUND= 

A/ 

S/ 

M 

5 

D 

NEWC 

REL 

41 

4432 

yy/mm/dd. SUBROUTINEOPT=0,ROUND= 

A/ 

S/ 

M 


NEWC 








6 

LIBRARY 

OPLD 

15 

7700 

yy/mm/dd. 




7 

* EOF * 

SUM = 

262 
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Example 3: 


This submit job uses LIBGEN to generate a user library file from the program library file 
TES2LIB created in example 2. 

/JOB 

LIBTES3. 

/USER 

ATTACH,TES2LIB. 

DEFINE,LIBFILE. 

LIBGEN,F=TES2LIB,F>=LIBFILE,N=L0ADLIB. 

CATALOG,LIBFILE,R,U. 

/EOF 

The program library TES2LIB is attached to the job. A direct access file LIBFILE is defined 
for writing the user library file. 

LIBGEN scans TES2LIB and builds a ULIB directory of entry points, program names, and external 
references for relocatable (REL) records in the file. ULIB is copied to the file LIBFILE, 
followed by the records from TES2LIB. A file index of addresses for each record in the file 
is added as the last record of LIBFILE. LOADLIB is the name of the ULIB and OPLD records. 

The CATALOG output of the user library file LIBFILE shows the following content. 

CATALOG OF LIBFILE FILE 1 yy/mra/dd. hh.mni.ss. PAGE 1 

REC NAME TYPE LENGTH CKSUM DATE COMMENTS 

1 LOADLIB ULIB 13 7725 yy/tnm/dd. 

2 A REL 41 7424 yy/mm/dd. SUBROUTINEOPT=0,ROUND= A/ S/ M 

A 

3 B REL 41 0465 yy/mm/dd. SUBROUTINEOPT=0,ROUND= A/ S/ M 

B 

4 BONE REL 41 4312 yy/mm/dd. SUBROUTINEOPT=0,ROUND= A/ S/ M 

BONE 

5 0 REL 41 6566 yy/mm/dd. SUBR0UTINE0PT=0,R0UND= A/ S/ M 

D 

6 NEWC REL 41 4432 yy/mm/dd. SUBROUTINEOPT=0,ROUND= A/ S/ M 

NEWC 

7 LOADLIB OPLD 15 0515 yy/mm/dd. 

8 * EOF * SUM = 275 
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Example 4: 

This submit job illustrates a method for deleting records from a user library. 


/JOB 

LIBTCS4. 

/USER 

ATTACH,aBFILE/M=W. 

LIBE DIT,P=LIBFILE,U,Z.# *D,REL /NEW C 
CATALOG, NEW, R,U. 

/EOR 

LIBEDIT references the program library LIBFILE and the directive following the command, 
deletes NEWC, and writes this modified file on the default NEW. The output shows the 
LIBEDIT processing. 

LIBEDIT DIRKTIVES. yy/iran/dd. hhjnn.ss. F^GE 1 


*D,REL/NEWC 


RECORDS WRITTEN ON FILE NEW yy/mm/dd. hh.mm.ss. FIAGE 2 



RECORD 

TYPE 

FILE 

DATE COMMENT 




A 

REL 

LIBFILE 

yy/nmi/dd. SlBR0UTINE0PT=O,R0UND= A/ 

S/ 

M 


B 

REL 

LIBFILE 

yy/mm/dd. SUBR0Urir€0PT=0,R0UND= A/ 

S/ 

M 


BONE 

REL 

LIBFILE 

yy/mm/dd. SlBR0UTINE0PT=0,R0UND= A/ 

S/ 

M 


D 

REL 

LIBFILE 

yy/mm/dd. SlBR0UTINE0FT=0,R0LND= A/ 

S/ 

M 

DELETED- 

(NEWC) 

REL 

LIBFILE 



ADDED 

LQADLIB 

OPLD 

***** 

yy/mm/dd. 




**EOF** 


LIBFILE 





LIBGEN generates a new user library on the file NEW. It uses LIBFILE as the source and 
names the new user library ULIB. 
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LIBRARY COMMAND 


The LIBRARY command specifies a global library set for your current job. Once you specify a 
global library set, you can execute any program or procedure on a global library file by 
entering the entry point name for the program or procedure name. Special entry points ARG=, 
NPC=, RFL=, and SDM= are also honored. (Refer to Volume 4, Program Interface for more 
information.) A program can load overlays randomly from this global library set. 

Format: 


LIBRARY,filej^ ,file 2 , . . . .filcn/directive 


Parameter 
file^ 

directive 

A Add the specified files to the global library set. 

D Delete the specified files from the global library 

set. 

R Replace the existing global library set with the 

specified files. R is the default. 


Description 


Specifies a file containing a user library. The file must be a local 
file or a system library. 

Specifies if filej^ ,file2,...filen are to be added to, to be 
deleted from or to replace the global library set. 

directive Description 


To clear your global library set, specify no parameters: 


LIBRARY. 


NOTE I 

A no-auto-drop status is set for any file 
inserted in the global library set. The 
no-drop-status is cleared when a library is 
removed from the global library set. Refer 
to SETFS command for an explanation of 
no-auto-drop status. 


MAXIMUM SIZE OF GLOBAL LIBRARY SET 

The maximum number of libraries allowed in your global library set varies with the number of 
nonsystem libraries you specify. Figure 15-4 shows the various possibilities: 



Number of system 

Maximum number 

User libraries 

libraries allowed 

of libraries 

0 

24 

24 

1 

13 

14 

2 

2 

4 
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Nominally, you can never specify more than two user libraries (nonsystem libraries). 

However, you can circumvent this restriction by making the local file name of a user library 
the same as that of a system library. The system libraries USRLIBl, USRLIB2,..., and 
USRLIB8 are available for this purpose. 


LIBRARY SEARCH ORDER 

The system searches the libraries in the global library set in the order in which you 
specified them in the LIBRARY command. If an entry point name appears in multiple 
libraries, the system uses its first occurrence. If you want to further control the library 
search order, use the LIBLOAD and SATISFY commands, described in the CYBER Loader Reference 
Manual. 


EXAMPLES 

Suppose you want to write a command to yield the date and another to yield your social 
security number. This example uses a procedure to produce the date and a FORTRAN 5 program 
to display your social security number. 

File DATPROC has the following contents: 

.PROC,DATE*I. 

DISP,$TODAY'S DATE IS;$,DATE+. 

REVERT/NOLIST. 

—eor™ 

.PR0C,DISP*I,STRING1,STRINGS. 

N0TE.+STRING1 STRINGS 
REVERT,NOLIST. 

File SSPROG has the following contents: 

PROGRAM SSNUM 

PRINT*,'MY SOCIAL SECURITY NUMBER IS 530-8S-7161.' 

END 


The following command entries establish your global library set: 


/get,datproc,ssprog. 

/ftn5,i=ssprog,l=0. 

0.009 CP SECONDS COMPILATION TIME. 

/Libedit,n=myLib,u,z.+*file datproc 
RECORDS WRITTEN ON FILE MYLIB 

RECORD TYPE FILE DATE COMMENT 


ADDED SSNUM REL 

ADDED DATE PROC 

ADDED DISP PROC 

LIBRARY GENERATION COMPLETE. 
/Library,myLib 
LIBRARY,MYLIB. 


LGO yy/mm/dd. 

DATPROC 

DATPROC 
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The FTN5 command creates file LGO and LIBEDIT creates user library MYLIB, containing the 
procedure and compiled program. The LIBRARY command specifies your global library set. 

The following sequence tests your commands: 

/date 

TODAY'S DATE IS: yymradd 
/ssnum 

MY SOCIAL SECURITY NUMBER IS 530-82-7161. 

0.003 CP SECONDS EXECUTION TIME. 

Suppose you wish to include three of your own user libraries in the global library set for 
your current job. You can accomplish this with the following commands: 

/get, raylibi, mylibZ, niylib3. 

/library, mylibl, mylibZ, myLib3. 

TOO MANY USER LIBRARIES SPECIFIED. 

/rename, usrlibl = myLib3. 

/Library, mylibl, raylibZ, usrlibl. 

LIBRARY, MYLIB1, MYLIBZ, USRLIBI. 

Note that it was necessary to use the name of a system library USRLIBI for the third library 
MYLIB3 in order to use more than two libraries at once. 

The following command produces a display of your global library set: 

/enquire,L 

LOADER INFORMATION. 

HAP OPTIONS = DEFAULT 
DEBUG = OFF 
GLOBAL LIBRARY SET IS - 
MYLIB1, MYLIBZ, USRLIBI 
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TERMINAL INPUT/OUTPUT 


16 


This section distinguishes NAM/CCP network functions from lAF functions to aid in error 
checking and to allow you to carry over knowledge of the network to other products (RBF or 
TAF, for example). If you are connected to a CDCNET network, refer to the CDCNET Terminal 
Interfaces Usage manual for a description of terminal input and output. The network 
interface is largely invisible to the lAF user. In most cases, you can ignore the existence 
of the network and proceed as if you are communicating exclusively with lAF. However, 
certain commands which involve communication only with the network are available to the lAF 
user (appendix J). These network commands change the characteristics of a terminal (for 
example, changing the backspace character or initiating paper tape operations), change the 
character code set of a terminal, and send messages to the local operator. Unlike other 
system commands, these network commands can be used any time a data connection exists between 
the terminal and the communications network, including prior to the completion of login. 


TERMINALS 

lAF and the network provide support for 18 terminal classes.t Each terminal class 
corresponds to an actual terminal or terminals as follows: 


Class 

1 

2 

3 

4 

5 

6 

7 

8 
9 

10 

11 

12 


Terminal 

M33, M35, M37, M38 teletypes 
CDC 713-10, 722, 751-1, 752, 756 
CDC 721, 722-30 
IBM 2741 
MAO 

Hazeltine 2000 

Terminals conforming to the ANSI X3.64 standard (DEC VTIOO, 
TeleVideo 924, 950, 955) 

Tektronix 4010, 4014 

HASP protocol post-print format control 
200 User Terminal 
CDC 714-30 
CDC 711-10 


13 CDC 714-10/20 

HASP protocol pre-print format control 

tTerminals of all classes can be connected to NOS. Some terminals in terminal classes 1, 
2, 3, and 5 through 8 can be connected to a packet switching network (PSN) with a 
connection established to NOS. 
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Class 

Terminal 

15 

CDC 

731-12 

16 

IBM 

2780 

17 

IBM 

3780 

18 

IBM 

3270 


734 


A computer site may support terminals other than those listed. Consult local site personnel 
to determine if terminal types not listed are supported and to obtain additional operating 
instructions for supported nonstandard terminals. 

Associated with each terminal class are specific terminal operating characteristics. Default 
values are listed in appendix J. A site can change these default values. If it does, it 
should provide you with a list of the new values. You can also change terminal character¬ 
istics with the TRMDEF command (section 8) and with the terminal definition commands 
(appendix J). Important characteristics which may vary from terminal to terminal include: 

• Abort output block character (AB). 

• Backspace character (BS). 

• Cancel character (CN). 

• Control character (CT). 

• End-of-line character (EL). 

• End-of-block character (EB). 

• Interruption character (Bl). 

• Termination character (B2). 


INPUT/OUTPUT CONVENTIONS 

There are many standards and conventions that apply to input and output. Some features, 
however, vary according to terminal class as this section indicates. The information in 
this section pertains to line mode operations only. 


INPUT FROM TERMINAL 

The system normally issues you input prompts. However, you need not wait for an input prompt 
before entering the next input line (refer to Entering Input Before Prompts later in this 
section). Any input from the terminal halts output to the terminal until you enter a . 

A question mark (?) output to the terminal is usually a request from an executing program 
for user input. You can enter terminal definition commands in response to any request for 
input. For example, when you are in text mode or are using Text Editor or FSE, If you 
enter a terminal definition command following a request for input, the system does not send 
a new prompt. 

If you are at a PSN terminal, however, you must wait for output to cease before entering 
more input. 
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LENGTH OF OUTPUT/INPUT LINES 


A logical input line can consist of a maximum of 2500 characters,t but the system does not 
impose a limit on the length of a logical output line. The current page widthtt determines 
the maximum number of characters in a physical output line. If a logical output line 
exceeds the current page width, the system places the additional characters on the next 
physical line. If you enter a logical input line (terminated by a carriage return) longer 
than 2500 characters, the system discards the entire logical line and issues the *0VL* 
message. 


TERMINATING INPUT LINE 

The line feed key, which terminates physical lines, and the carriage return key, which 
terminates logical lines, vary with terminal class. Appendix K lists the carriage return, 
line feed, and message transmission keys for the various terminal classes. Line feed and 
carriage return are generic terms which represent characters that terminate a line of text. 
The logical end-of-line character can be changed by you (refer to the EL command in appendix 
J), your application, or by your local site. 

You must terminate each logical line of input by entering a carriage return. This tells the 
system that the current logical line is complete. The system may respond by positioning the 
cursor) at the beginning of the next line. You can then enter additional input 
information on the new line, ttt 

You continue a logical line on a new physical line by entering a line feed. The system 
responds by positioning the carriage (or cursor) at the beginning of the next line. 


CORRECTING INPUT LINE 

You can correct entry errors in the input line before pressing® by using the backspace 
character. One character (including spaces) is deleted for each backspace character 
entered. If the beginning of the physical line is reached, further backspace characters are 
Ignored. For example, when the input line contains 

BAX«—SJK*- IC 

it is interpreted by the system as the BASIC subsystem selection command (or a line of text 
Interpreted as the word BASIC, if you are in text mode). 

The backspace character can be changed by you (refer to the BS command in Appendix J), your 
application, or by your site. 


t This applies only to lAF and can be changed by your site. 

ttThis characteristic varies with the terminal class. You can change this characteristic 
with the TRMDEF command (section 8) or with one of the terminal definition commands 
(appendix J). 

tttA PSN does not normally reposition its terminals to the next line until it sends the next 
output message. You must reposition the carriage on terminals connected to a PSN (for 
example, by entering a carriage return in local mode in order to enter input before the 
system prompts for it). 
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DELETING INPUT LINE 


When you discover an error in the command or other input before pressing you can delete 
the current logical input line by entering the cancel line charactert followed by a carriage 
return. For most terminals, this is CTRL/X or the ( character. Default values for each 
terminal class are given in appendix J. 

The network responds to the cancel line character by printing *DEL* on the next line and 
positioning the carriage or cursor to the beginning of a new line. The following example 
illustrates the use of the cancel line character. 

READY. 

10 program t 
20 print 6 

30 6 format 9'this is a test You enter the cancel line character. 

*DEL* 

30 6 format ('this is it') 

AO end 
List 

10 PROGRAM T 
20 PRINT 6 

30 6 FORMAT ('THIS IS IT') 

40 END 

READY. 


ENTERING INPUT BEFORE PROMPTS 

Under lAF, you normally wait for an input prompt before entering data or commands. This 
prompt appears as either a READY message, a slant (/), a question mark (?), or a 
program-defined prompt. You can, however, enter input before receiving a prompt; the system 
processes the input in the order that you enter it. The prompts the system issues after 
processing individual commands still appear at the terminal in their normal manner. If you 
enter too many commands before receiving an input prompt, the system issues the following 
message; 

WAIT.. 

You should then reenter the unprocessed commands after the system issues its REPEAT., prompt. 

Even if it is currently processing another command, the system processes these three types 
of input imnediately: terminal definition commands, interactive status commands, and user 
break sequences (interruption and termination sequences). 

Terminal definition commands change the terminal's characteristics. Appendix J gives a 
detailed description of terminal definition commands. 

Interactive status commands get an immediate status response from the system. The 
interactive status commands, ctD, ctE, and ctS, use the network control character defined 
for your terminal (refer to table J-1). Detailed descriptions of ctD, ctE, and ctS appear 
in section 8. 


tihis characteristic varies with the terminal class. You can change this characteristic 
with the TRMDEF command (section 8) or with one of the terminal definition commands 
(appendix J). 
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PAGE WAIT 


Each terminal class defines a certain number of lines of output as a page.t For a display 
terminal with page wait enabled, output stops at each page boundary. To display the next 
page, you can enter a carriage return .ft For a printing terminal with page wait enabled, the 
system Inserts six line feeds at each page boundary and output continues. If output ceases 
and the message 

OVER.. 

is displayed at the end of the output, while the present page is not full, another page 
exists and can be viewed by pressing @ . 


SUSPENDING OUTPUT 

The procedure for suspending output varies with the terminal type. To suspend output on 
asynchronous terminals (terminal classes 1 through 8), you can press the RFFAif key (the 

BREAK key is sometimes labeled INT, INTRPT, or ATTN). You can also suspend output by 

pressing any other key.ttt You can then enter the cancel line character (CN)t followed by a 
carriage return to continue output and to avoid having the keyed entry interpreted as input. 

Synchronous terminals do not have a BREAK key. You cannot suspend output on these 

terminals, except through the normal page wait controls. 

After suspending output with the BREAK key, you can either abort the current output block, 
interrupt the current job step, or terminate the current job step. The next three 
subsections define the procedures for each of these options. If you enter input other than 
the controls described in the following sections, the system resumes output. 


ABORTING OUTPUT BLOCK 

To abort the current output block, first suspend output by pressing the BREAK key and then 
enter the abort block character followed by a carriage return.tttt 


tThis characteristic varies with the terminal class. It can be changed using the TRMDEF 
command (section 8) or one of the terminal definition commands (appei»lix J). 
ttFor mode 4 terminals, enter the network control character (ct) followed by a carriage 
■ return to see the next page. 

ttton asynchronous terminals connected to a PSN, you can only suspend output by using the 
BREAK key, which might result in the loss of data the PSN holds. 
ttttA PSN does not support the abort output block feature for its terminals. 


60459680 C 


16-5 




INTERRUPTING JOB STB> 

To Interrupt a job step, you enter the interruption charactert followed by a carriage 
return. For most terminals, the Interruption character is CTRL/P, CTRL/F, or a colon (:). 
Appendix J lists the default values for each terminal class. The interruption sequence is 
also called the user break 1 sequence. lAF responds with the message: 

*INTERRDPTED* 

and discards any input you may have previously entered. 

If the system is transmitting output to the terminal, first suspend output by pressing the 
BREAK key and then enter the interruption sequence. To interrupt output on S 3 mchronous 
terminals, you can enter the interruption sequence only when output ceases at a page 
boundary. You must have already enabled page wait. 


TERMINATING JOB STB> 

To terminate a job step, enter the termination charactert followed by a carriage return. 

For most terminals, the termination character is CTRL/T or a right parenthesis. Appendix J 
lists the default values for each terminal class. The termination sequence is also called 
the user break 2 sequence. lAF responds with 

*TEEMINATED* 

and discards any input you may have entered previously. 

If the system is transmitting output to the terminal, first suspend terminal output by 
pressing the BREAK key and then enter the termination sequence. To terminate output on 
synchronous terminals, you enter the termination sequence only when output ceases at a page 
boundary. You must have already enabled page wait. 


I NOTE I 

You cannot enter the interruption or 
termination sequence if output has been 
suspended with a key other than the BREAK 
key or the interruption or termination 
character. 


tThis characteristic varies 
command (section 8) or one 


with the terminal class. It can be changed using the TRMDEF 
of the terminal definition commands (appendix J). 
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CONTINUING A SUSPENDED JOB 

After you have suspended your job during program execution by entering the interruption 
sequence, you can enter one of the following: 

Entry Description 

@ Continues output. A.portion of the output is lost if the program 

was transmitting output to the terminal when suspended. When output 
is complete, program execution continues. 

P Proceeds. If the program was transmitting output to the terminal 

when suspended, the system discards the data generated by the 
program prior to the interruption sequence. The amount of output 
discarded depends on the program being executed. Program execution 
continues. 

Other Stops. Terminates the job step. 
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The following example Illustrates the use of the interruption sequence to interrupt a 
FORTRAN 5 program. 

I ist 

00100 PROGRAM DO 
00110 INTEGER E 
00120 DO 10 E=1,300 
00130 PRINr*,E 
00140 1 0 CONTINUE 
00150 READ*,I,J 
CH3160 PRINT*,I,J 
00170 STOP 
00180 END 
READY, 
run 

1 

2 

3 


★INTERRUPTED* 

110 

111 

112 

★INTERRUPTED* 

193 

194 

195 

196 

★INTERRUPTED* 
? 4,5 


You interrupt with the BREAK key to stop 
output and enter the interruption 
sequence to suspend the job. You 
continue by pressing («) (some output is 
lost). 

You again press the BREAK key to stop 
output and enter the interruption 
sequence to suspend the job. 

You enter P@» directing the system to 
discard dat£r. As execution continues, 
more data is printed at the terminal. 

You again suspend the job. 

You enter P@.directing the system to 
discard data« All output has been 
generated. Program execution continues. 


SRU 0.863 UNTS. 
RUN COMPLETE. 


The number of times you would have 
to interrupt a program and enter P 
before all output has been generated 
depends on the program. 


USING AnN ON IBM 2741 TERMINALS 

You must press the ATTN key before entering the network control character, abort block 
character, interruption character, or termination character or after entering the cancel 
character. For further information about these characters, refer to appendix J. 
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CONTROL BYTK 


You can design an interactive program to control terminal activity by including control 
bytes in your output. Control bytes perform operations such as controlling the positioning 
of the printing element and defining alternate input modes. 

A control byte is a 12-bit quantity, right-justified in bit position 0, 12, 24, 36, or 48 of 
a central memory (CM) word. You must be careful since data can be mistaken for a control 
byte. For example, the 64-character set characters :D at the beginning of a line and 
followed by an end-of-line may log out your job if written to the terminal output file, 
since the code 0004 is transmitted. The following control bytes are available. 


Byte 

Description 

0001 


or 

End-of-block. 

0002 


0003 

Auto input. 

0004 

Disconnect terminal from lAF and the host. 

0005 

Initiate ASCII input mode. 

0006 

Initiate transparent input mode. 

0007 

Initiate transparent output mode. 

0010 

NAM/CDCNET terminal redefinition. 

0011 

Initiate ASCII output mode. 

0013 

End-of-string. 

0016 

NAM/CCP terminal redefinition. 


The use of these control bytes is described in detail in section 12 of Volume 4, Program 
Interface. For additional information, refer to the EFFECT macro description in Volume 4. 
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CHARACTER SETS 


A 


A character set is composed of graphic aod control characters* A code set is a, set of codes 
used to represent each character within a character set. 

A graphic character may be displayed at a term in a l or printed by a line printer. Examples 
are the characters A through Z and the digits 0 through 9. A control character initiates, 
modifies, or stops a control operation. An example is the backspace character that moves 
the terminal carriage or cursor back one space, ^though a control character is not a 
graphic character, a terminal may produce a graphic representation when it receives a 
control character. 

All references within this manual to the ASCII character set or the ASCII code set refer to 
the chara:ter set and code set defined in the Anerican Ifetional Standard Code for 
Information Interchange (ASCII, AIBI Standard X3.4-1977). References in this manual to the 
AK:iI character set do not necessarily refer to the ASCII code set. 

NOS supports the following character sets. 

• CDC graphic 64- (or 63-) character set. 

• ASCII 128-character set. 

• ASCII graphic 64- (or 63-) character set. 

• ASCII graphic 95-character set. 

Each installation selects either the 64-character set or the 63-character set. The 
differences between the two are described In Character Set Anomalies in this appendix. Any 
reference in this appendix to the 64-character set implies either the 63- or 64-character 
set, unless otherwise stated. 

NOS supports the following code sets. 

• 6-bit display code. 

• 6/12-bit display code. 

• 7-bit ASCII code. 

Display code is a set of 6-bit codes from OOg to Ilg. 

The 6/12-bit display code is a combination of 6-bit codes and 12-bit codes. The 6-bit codes 

are OOg through 77g, excluding 74g and 76g. (Refer to Character Set Anomalies for 

the interpretation of the OOg and 63g codes.) The 12-bit codes begin with either 74g 

or 76g and are followed by a 6-blt code. Ihus , 74g and 76g are considered escape 

codes and are never used as 6-bit codes within the 6/12-bit display code set. The 12-bit 

codes are TAOlg, 7402g, 7404g, 7407g, and 7601g through 7677g. Ail other 12-bit 

codes (74xxg and 7600g) are undefined. 
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The 7-bit ASCII code (as defined by AKSI Standard X3.4-1977) is right-justified in a 12-bit 
byte. Assuming that the bits are numbered from the right starting with 0, bits 0 through 6 
contain the ASCII code, bits 7 throtigh 10 contain zeros, and bit 11 distinguishes the 
OOOOg code from the end-of-line byte. The 7-bit codes are OOOlg through 0177 q and 
40003. 


CHARAaER SET ANOMALIES 

NOS interprets two codes differently \pdien the installation selects the 63-character set 
rather than the 64-character set. In tables A-1, A-2, and A-3, the codes for the colon and 
percent graphic characters in the 64-character set are unshaded; the codes for the colon and 

percent graphic characters in the 63-character set are shaded. 

If an installation vises the 63-character set, the colon graphic character is always 
represented by a 63g code, and the OO 3 code is undefined. Hiwever, if the installation 
uses the 64-character set, output of 6/12-bit display codes 74043 or 6-bit display code 
OO 3 produces a colon. In ASCII mode for interactive jobs, a colon can be input only as a 
74043 6/12-bit display code. 

When using either the 63- or 64-character set, the use of undefined 6/12-bit display codes 
in output files produces unpredictable results and should be ctvoided. 

On. input, NOS recognizes alternate 029 punch codes of 11-0 for the right bracket (]) and 

12-0 for the left bracket ([). The alternate codes support the COBOL sign overpunch 
convention and are not recommended for other uses. Eefer to COBOL 5 Reference Manual. 

Also, two OOg codes may be confused with an end-of-line byte and shovild be avoided (refer 
to appendix F for further explanation). 

Translation of 7-blt ASCII to 6 -bit display code causes character set folding from the 
128-character ASCII set to the 63- or 64-character ASCII svibset. The following special 
character substitutions occur; 

7-Bit ASCII 6 -Bit Display Code 7-Bit ASCII 

Code Charac ter Code_Charac ter Code Charac ter 


0140 

> 


74 



0100 

@ 

0173 

{ 


61 

[ 


0133 

[ 

0174 



75 

\ _ 

V 

0134 

\ 

1 — 




\ 

0175 

} 


62 

] 


0135 

] 

0176 

- 


76 

- 


0136 

- 


CHARAaER SET TABLES 

This appendix contains character set tables for interactive jobs, batch jobs, and jobs 
involving magnetic tapes. Table A-1 is for interactive jobs, and table A-2 is for batch 
jobs. Tbble A-3 is a conversion table used to cross-reference 7-bit ASCII codes and 
6/12-bit display codes and to convert ASCII codes from octal to hexadecimal. 

Tables A-4, A-5, and A -6 list the magnetic tape codes and their display code equivalents. 
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The character set tables are designed so that you can find the character represented by a 
code (such as in a dump) or find the code that represents a character. To find the 
character represented by a code, look up the code in the column listing the appropriate code 
set and then find the character on that line in the column listing the appropriate character 
set. To find the code that represents a character, you first look up the character and then 
find the code on the same line in the appropriate column. 


INTERACTIVE JOBS 

Table A-1 shows the character sets and code sets available to you at an ASCII code 
terminal. When in NORMAL mode (specified by the NORMAL command), NOS displays the ASCII 
graphic 64-character set and interprets all input and output as 6-bit display code. When in 
ASCII mode (specified by the ASCII command), NOS displays the ASCII 128-character set and 
interprets all input and output as 6/12-bit display code. 

To determine the octal or hexadecimal ASCII code for a character, refer to table A—3. 
(Certain terminal definition commands require specification of an ASCII code.) 

On output, the US code is reserved for network use and defined as an end-of-line. Use of 
this character, except in transparent mode, causes incorrect formatting and possible loss of 
output characters. 


BATCH JOBS 

Table A-2 lists the CDC graphic 64-character set, the ASCII graphic 64-character set, and 
the ASCII graphic 95-character sets. It also lists the code sets and card punch codes (026 
and 029) that represent the characters. 

The 64—character sets use display code as their code set; the 95-character set uses either 
ASCII display code or 7-bit (8/12) ASCII code. The 95—character set is composed of all 
the characters in the ASCII 128—character set that can be printed at a line printer (refer 
to Jobs using Line Printers). 7—Bit (8/12) ASCII code files can be printed by routing the 
files with EC=A9; 6/12 ASCII files can be printed by routing the files with EC=A9, FC=ASCII6. 


JOBS USING UNE PRINTERS 

The batch character set printed depends on the print train used on the line printer to which 
the file is sent. In addition, you may choose from one of several subsets of the characters 
on the print train by specifying the print train image (for information on specifying print 
train images, refer to the ROUTE command in section 9). 

The following table lists the print trains according to the associated ROUTE command EC 
parameter values. 
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Print 

Train 

ROUTE EC Values 

That Will Print 

ROUTE EC Values 

That Will Not Print 

Suggested 

Print Band 

Of 

NONE,B4,B6 

A4,A6,A9 

595-1/596-1 

1 

NONE,B4,B6 

A4,A6,A9 

595-1/596-1 

2t 

N0NE,B4,B6 

A4,A6,A9 

595-1/596-1 

3t 

NONE,B4,B6 

A4,A6,A9 

595-1/596-1 

4 

N0NE,A4,A6,A9 

B4,B6 

595-6/596-6 

5 

NONE,A4,A6 

B4,B6,A9 

595-4/596-4 




or 




595-5/596-5 

6 

A9 

NONE,B4,B6,A4,A6 

595-6/596-6 

7 

NONE,B4,B6,A4,A6,A9 


595-6/596-6 

tThese print trains are reserved for future use. If specified, they have the same 

effect as 

if print train 1 had been specified. 



For PSU printers, the batch character sets and associated print bands are as follows: 

Character Set 533/536 Print Band 

ASCII graphic 64-character set 530-1 

ASCII graphic 95-character set 530-2 

The characters of the default 596-1 print train are listed in the table A-2 column labeled 
CDC Graphic (64 Char); the 596-5 print train characters are listed in the table A-2 column 
labeled ASCII Graphic (64 Char); and the 596-6 print train characters are listed in the 
table A-2 column labeled ASCII Graphic (95 Char). 

If a transmission error occurs when printing a line, the system prints the line again. The 
CDC graphic print train prints a concatenation symbol (r^) in the first printable column of 

the repeated listing of the line. The ASCII print trains print an underline (_) Instead of 

the concatenation symbol. 

If an unprintable character exists in a line (that is, a 7-bit ASCII code outside the range 
0040g through OnSg), the number sign (//) appears in the first printable column of a 
print line, and a space replaces the unprintable character. 

To route and correctly print a 6/12-bit display code file on a line printer with the ASCII 

■ graphic 95-character set, you must specify IC=ASII6 as well as EC=A9 on the ROUTE COMMAND. 
For 7-bit (8/12) ASCII files, for example those produced by FCOPY, you can omit the 1C 
parameter or specify IC=ASCII and include the EC=A9 parameter. 
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Table A-1. Character Sets for Interactive Jobs (Sheet 1 of 2) 


ASCII 

Graphic 
(64 Character) 

ASCII 

Character 
(128 Character) 

6-Bit 

Display 

Code 

6/12- 
Bit 

Display 

Code 

7-Bit 

ASCII 

Code 


ASCII 

Graphic 
(64 Character) 

ASCII 
Character 
(128 Character) 

6-Bit 

Display 

Code 

6/12- 
Bit 

Display 

Code 

7-Bic 

ASCII 

Code 

: colon 


00^'..... 




t number sign 

# number sign 

60 

60 

0043 


^ the- 


( opening bracket 

[ opening bracket 

61 

61 

0133 

A 

A 

01 

01 

0101 


} closing bracket 

j closing bracket 

62 

62 

0135 

B 

B 

02 

02 

0102 


Z percent sign 

X percent sign 

63 

63t 

0045 

C 

C 

03 

03 

0103 



I'd’ 

mr-M 




D 

04 

04 

0104 


*' quote 

" quote 

64 

64 

0042 


£ 

05 

05 

0105 


underline 

underline 

65 

65 

0137 

F 

F 

06 

06 

0106 


! exclamation point 

! exclamation point 

66 

66 

0041 

G 

G 

07 

07 

0107 


& ampersand 

& ampersand 

67 

67 

0046 







' apostrophe 

' apostrophe 

70 

70 

0047 

H 

H 

10 

10 

0110 


? question mark 

? question mark 

71 

71 

0077 

I 

I 

11 

11 

0111 


< less than 

< less than 

72 

72 


J 

J 

• 12 

12 

0112 


> greater than 

> greater than 

73 

73 

0076 

K 

K 

13 

13 

0113 


8 commercial at 

@ commercial at 

74t 

7401 

0100 

L 

L 

14 

14 

0114 


\ reverse slant 

\ reverse slant 

75 

75 

0134 

M 

M 

15 

15 

0115 


circumflex 

circumflex 

76t 

7402 

0136 

N 

N 

16 

16 

0116 


; semicolon 

; semicolon 

77 

77 

0073 

0 

0 

17 

17 

0117 














: colon 


7404 

0072 

P 

P 

20 

20 

0120 



:S!7jerwnsiiS 

, ■ 

mmi 

wmm 

Q 

Q 

21 

21 

0121 



grave accent 

741" 

7U07 

0140 

R 

R 

22 

22 

0122 







S 

S 

23 

23 

0123 



a 


7601 

0141 

T 

T 

24 

24 

0124 



b 


7602 

0142 

U 

U 

25 

25 

0125 



c 


7603 

0143 

V 

V 

26 

26 

0126 



d 


7604 

0144 

W 

w 

27 

27 

0127 



e 


7605 

0145 








f 


7606 

0146 , 

X 

X 

30 

30 

0130 



g 


7607 

0147 

Y 

Y 

31 

31 

0131 







Z 

z 

32 

32 

0132 



h 


7610 

0150 

0 

0 

33 

33 

0060 



i 


7611 

0151 

1 

1 

34 

34 

0061 



i 


7612 

0152 

2 

2 

35 

35 

0062 



k 


7613 

0153 

3 

3 

36 

36 

0063 



1 


7614 

0154 

4 

4 

37 

37 

0064 



m 


7615 

0155 








n 


7616 

0156 








0 


7617 

0157 

5 

5 

40 

40 

0065 







6 

6 

41 

41 

0066 



P 


7620 

0160 

7 

7 

42 

42 

0067 



9 


7621 

0161 

8 

8 

43 

43 

0070 



r 


7622 

0162 

9 

9 

44 

44 

0071 



s 


7623 

0163 

+ plus 

+ plus 

45 

45 

0053 



t 


7624 

0164 

- dash 

- dash 

46 

46 

0055 



u 


7625 

0165 

* asterisk 

* asterisk 

47 

47 

0052 



V 


7626 

0166 








V 


7627 

0167 

■ / slant 

/ slant 

50 

50 

0057 



X 


7630 

0170 

( opening parenthesis 

( opening parenthesis 

51 

51 

0050 



y 


7631 

0171 

) closing parenthesis 

) closing parenthesis 

52 

52 

0051 



z 


7632 

0172 

$ dollar sign 

$ dollar sign 

53 

53 

0044 



{ opening brace 

61t 

7633 

0173 

■ equal 

* equal 

54 

54 




1 vertical line 

751 

7634 

0174 

space 

space 

55 

55 




} closing brace 

621 

7635 

0175 

, comma 

p comma 

56 

56 




~ tilde 

761 

7636 

0176 

. period 

• period 

57 

57 

212 



DEL 


7637 

0177 


+The interpretation of this character or code may depend on its context. Refer to Character Set Anomalies elsewhere in this appendix. 
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Table A-1. Character Sets for Interactive Jobs (Sheet 2 of 2) 





6/12- 






6/12- 


ASCII 

ASCII 

6“Bit 

Bit 

7-Bit 


ASCII 

ASCII 

6-BiC 

Bit 

7-Bit 

Graphic 

Character 

Display 


ASCII 


Graphic 

Character 

Display 

Display 

ASCII 

(64 Character) 

(128 Character) 

Code 

Code 

Code 


(64 Character) 

(128 Character) 

Code 

Code 

Code 


NUL 


7640 

4000 



DLE 


7660 

0020 


SOH 


7641 

0001 



DCl 


7661 

0021 


SIX 


7642 

0002 



DC2 


7662 

0022 


m 


7643 

0003 



DC3 


7663 

0023 


EOT 


7644 

0004 



DC4 


7664 

0024 


ENQ 


7645 

0005 



NAK 


7665 

0025 


ACK 


7646 

0006 



SYN 


7666 

0026 


BEL 


7647 

0007 



ETB 


7667 

0027 


BS 


7650 

0010 



CAN 


7670 

0030 


HT 


7651 

0011 



EM 


7671 

0031 


LF 



0012 



SUB 


7672 

0032 


VT 



0013 



ESC 


7673 

0033 


FF 



0014 



FS 


7674 

0034 


CR 



0015 



GS 


7675 

CK)35 


SO 



0016 



RS 


7676 

0036 


SI 


m 

0017 



ust 


7677 

0037 

tReserved for network 

use. Refer to Character Set Tables in this appendix. 
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Table A-2. Character Sets for Batch Jobs (Sheet 1 of 3) 


CDC 

Graphic 
(64 Character) 


colorit 


ASCII 
Graphic 
(64 Character) 


ASCII 
Graphic 
(95 Character) 


6-Bit 6/12-Bit 7-Bit 
Display Display ASCII 
Code Code Code 


5 

6 

7 

8 
9 

+ plus 
- dash 
* asterisk 


elsewhere in this appendix. 



Punch Code 

026 

029 

8-2 

8-2 




■|||yMmy|||Hl 

12-2 

12-2 

12-3 

12-3 

12-4 

12-4 

12-5 

12-5 

12-6 

12-6 

12-7 

12-7 

12-8 

12-8 

12-9 

12-9 

11-1 

11-1 

11-2 

11-2 

11-3 

11-3 

11-4 

11-4 

11-5 

11-5 

11-6 

11-6 

11-7 

11-7 

11-8 

11-8 

11-9 

11-9 

0-2 

0-2 

0-3 

0-3 

0-4 

0-4 

0-5 

0-5 

0-6 

0-6 

0-7 


0-8 

0-8 

0-9 

0-9 

0 

0 

1 

1 

2 

2 

3 

3 

4 

4 

5 

5 

6 

6 

7 

7 

8 

8 

9 

9 

12 

12-8-6 

11 

11 

11-8-4 

11-8-4 
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Table A-2. Character Sets for Batch Jobs (Sheet 2 of 3) 


CDC 

ASCII 

ASCII 

6-Bit 

6/12-Bit 

7-Bit 



Graphic 

Graphic 

Graphic 

Display 

Display 

ASCII 

Punch Code I 



(64 Character) 

(64 Character) 

(95 Character) 

Code 

Code 

Code 

026 

029 

/ slant 

/ slant 

/ slant 

50 

50 

0057 

0-1 

0-1 

( opening parenthesis 

( opening parenthesis 

( opening parenthesis 

51 

51 

0050 

0-8-4 

12-8-5 

) closing parenthesis 

) closing parenthesis 

) closing parenthesis 

52 

52 

0051 

12-8-4 

11-8-5 

$ dollar sign 

$ dollar sign 

$ dollar sign 

53 

53 

0044 

11-8-3 

11-8-3 

= equal 

= equal 

= equal 

54 

54 

0075 

8-3 

8-6 

space 

Space 

Space 

55 

55 

0040 

no punch 

no punch 

, comma 

, comma 

, comma 

56 

56 

0054 

0-8-3 

0-8-3 

. period 

. period 

. period 

57 

57 

0056 

12-8-3 

12-8-3 

= equivalence 

# number sign 

t number sign 

60 

60 

0043 

0-8-6 

8-3 

[ opening bracket 

[ opening bracket 

I opening bracket 

61 

61 

0133 

8-7 

12-8-2t 

] closing bracket 

] closing bracket 

] closing bracket 

62 

62 

0135 

0-8-2 

ll-8-2t 

% percent signt 

Z percent signt 

1 percent sign? 

63t 

63t 

0045 

8-6 

0-8-4 

: coloa 

# not equal 

colon 

quote 

: colon 
quote 

63 

^ 'll 

S 

0072 

004" 

8^4 

sS 

concatenation 

underline 

underline 

65 

65 

0137 


0-8-5 

V logical OR 

! exclamation point 

! exclamation point 

66 

66 

0041 

11-0 

12-8-7 

A logical AND 

& ampersand 

& ampersand 

67 

67 

0046 

0-8-7 

12 

superscript 

' apostrophe 

' apostrophe 

70 

70 

0047 

11-8-5 

8-5 

subscript 

? question mark 

? question mark 

71 

71 

0077 

11-8-6 

0-8-7 

< less than 

< less than 

< less than 

72 

72 

0074 

12-0 

12-8-4 

> greater than 

> greater than 

> greater than 

73 

73 

0076 

11-8-7 

0-8-6 

< less or equal 

@ commercial at 


74 



8-5 

8-4 

> greater or equal 

\ reverse slant 

\ reverse slant 

75 

75 

0134 

12-8-5 

0-8-2 

- logical NOT 

* circumflex 


76 



12-8-6 

11-8-7 

; semicolon 

; semicolon 

; semicolon 

77 

77 

0073 

12-8-7 

11-8-6 



@ commercial at 

74t 

7401 

0100 





* circumflex 

76t 

7402 

0136 






74t 

p' 


1 




a 


7601 

0141 





b 


7602 

0142 





c 


7603 

0143 





d 


7604 

0144 





e 


7605 

0145 





f 


7606 

0146 





g 


7607 

0147 



Tlhe interpretation 

of this character or code may depend on its 

context 

Refer 

to Character Set 

Anomalies 

elsewhere in this appendix. 








A-8 


60459680 C 































Table A-2. Character Sets for Batch Jobs (Sheet 3 of 3) 


CDC 

ASCII 

ASCII 

6-Bit 

6/12-Bit 

7-Bit 



Graphic 

Graphic 

Graphic 

Display 

Display 

ASCII 

Punch Code | 

(64 Character) 

(64 Character) 

(95 Character) 

Code 

Code 

Code 

026 

029 



h 



0150 





i 


7611 

0151 





j 


7612 

0152 





k 


7613 

0153 





1 


7614 

0154 





m 


7615 

0155 





n 


7616 

0156 





o 


7617 

0157 





p 


7620 

0160 





q 


7621 

0161 





r 


7622 

0162 





s 


7623 

0163 





t 


7624 

0164 





u 


7625 

0165 





V 


7626 

0166 





w 


7627 

0167 





X 


7630 

0170 





y 


7631 

0171 





Z 


7632 

0172 





{ opening brace 

6lt 

7633 

0173 





1 vertical line 

75t 

7634 

0174 





} closing brace 

62t 

7635 

0175 





“ tilde 

76t 

7636 

0176 



tXhe interpretation of this character or code may depend on its 
elsewhere in this appendix* 

context. 

Refer t 

o Character Set 

Anomalies 
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Table A-3. ASCII to 6/12-Bit Display Code Conversion (Sheet 1 of 2) 


ASCII 

7- 

Bit 

6/12-Bit 

ASCII 

7- 

Bit 

6/12-Bit 


ASCII Code 

Display 

Code 


ASCII Code 1 

Display 

Code 

(128 Character) 

Octal 

Hexadecimal 

(128 Character) 

Octal 

Hexadecimal 

NUL 

4000 

00 

7640 

■0 

0060 

30 

33 

SOH 

0001 

01 

7641 

1 

0061 

31 

34 

STX 

0002 

02 

7642 

2 

0062 

32 

35 

ETX 

0003 

03 

7643 

3 

0063 

33 

36 

EOT 

0004 

04 

7644 

4 

0064 

34 

37 

ENQ 

0005 

05 

7645 

5 

0065 

35 

40 

ACK 

0006 

06 

7646 

6 

0066 

36 

41 

BEL 

0007 

07 

7647 

7 

0067 

37 

42 

BS 

0010 

08 

7650 

8 

0070 

38 

43 

irr 

0011 

09 

7651 

9 

0071 

39 

44 

LF 

0012 

OA 

7652 

: colontt 

0072 

3A 

7404tt 

VT 

0013 

OB 

7653 



3A 

63 

FF 

0014 

OC 

7654 

; semicolon 

0073 

3B 

77 

CR 

0015 

OD 

7655 

< less than 

0074 

3C 

72 

SO 

0016 

OE 

7656 

= equal 

0075 

3D 

54 

SI 

0017 

OF 

7657 

> greater than 

0076 

3E 

73 





? question mark 

0077 

3F 

71 

DLE 

0020 

10 

7660 





DCl 

0021 

11 

7661 

@ commercial at 

0100 

40 

7401 

DC2 

0022 

12 

7662 

A 

0101 

41 

01 

DC3 

0023 

13 

7663 

B 

0102 

42 

02 

DCA 

0024 

14 

7664 

C 

0103 

43 

03 

NAK 

0025 

15 

7665 

D 

0104 

44 

04 

SIN 

0026 

16 

7666 

E 

0105 

45 

05 

ETB 

0027 

17 

7667 

F 

0106 

46 

06 





G 

0107 

47 

07 

CAN 

0030 

18 

7670 





EM 

0031 

19 

7671 

H 

0110 

48 

10 

SUB 

0032 

lA 

7672 

I 

0111 

49 

11 

ESC 

0033 

IB 

7673 

J 

0112 

4A 

12 

FS 

0034 

1C 

7674 

K 

0113 

4B 

13 

GS 

0035 

ID 

7675 

L 

0114 

4C 

14 

RS 

0036 

IE 

7676 

M 

0115 

4D 

15 

USt 

0037 

IF 

7677t 

H 

0116 

4E 

16 





0 

0117 

4F 

17 

space 

0040 

20 

55 




20 

! exclamation point 

0041 

21 

66 

P 

0120 

50 

" quote 

0042 

22 

64 

Q 

0121 

51 

21 

t number sign 

0043 

23 

60 

R 

0122 

52 

22 

$ dollar sign 

0044 

24 

53 

S 

0123 

53 

23 

% percent signtt 

0045 


63tf 

T 

0124 

54 

24 

“ *"i*amper sand 

0046 

26 

7404 

U 

V 

0125 

0126 

55 

56 

25 

26 

' apostrophe 

0047 

27 

70 

w 

0127 

57 

27 

( opening parenthesis 

0050 

28 

51 

X 

0130 

58 

30 

) closing parenthesis 

0051 

29 

52 

Y 

0131 

59 

31 

* asterisk 

0052 

2A 

47 

z 

0132 

5A 

32 

+ plus 

0053 

2B 

45 

[ opening bracket 

0133 

5B 

61 

f comma 

0054 

2C 

56 

\ reverse slant 

0134 

5C 

75 

- dash 

0055 

2D 

46 

] closing bracket 

0135 

5D 

62 

. period 

0056 

2E 

57 

* circumflex 

0136 

5E 

7402 

/ slant 

0057 

2F 

50 

underline 

0137 

5F 

65 


tReserved for network use. Refer to Character Set Tables in this appendix. 
ttThe interpretation of this character or code may depend on its context. Refer to Character Set Anomalies in 
this appendix. 
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Table A-3. ASCII to 6/12-Bit Display Code Conversion (Sheet 2 of 2) 


ASCII 

7 

-Bit 

6/12-Blt 

ASCII 

7 

-Bit 

6/12-Bit 

Character 

ASCII Code 



ASCII Code 


(128 Character) 

Octal 

Hexadecimal 

Code 

(128 Character) 

Octal 

Hexadecimal 

Code 

' grave accent 

0140 

60 


p 

0160 

70 

7620 

a 

0141 

61 


q 

0161 

71 

7621 

b 

0142 

62 


r 

0162 

72 

7622 

c 

0143 

63 


s 

0163 

73 

7623 

d 

0144 

64 

7604 

t 

0164 

74 

7624 

e 

0145 

65 

7605 

u 

0165 

75 

7625 

f 

0146 

66 

7606 

V 

0166 

76 

7626 

s 

0147 

67 

7607 

w 

0167 

77 

7627 

h 

0150 

68 

7610 

X 

0170 


7630 

i 

0151 

69 

7611 

y 

0171 


7631 

j 

0152 

6A 

7612 

Z 

0172 


7632 

k 

0153 

6B 

7613 

{ opening brace 

0173 


7633 

1 

0154 

6C 

7614 

1 vertical line 

0174 


7634 

m 

0155 

6D 

7615 

} closing brace 

0175 

7D 

7635 

n 

0156 

6E 

7616 

~ tilde 

0176 

7E 

7636 

o 

0157 

6F 

7617 

DEL 

0177 

7F 

7637 
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JOBS USING MAGNETIC TAPES 


Coded data to be copied from mass storage to magnetic tape is assumed to be represented in 
display code. NOS converts the data to external BCD code when writing a coded seven-track 
tape and to ASCII or EBCDIC code (as specified on the tape assignment command) when writing 
a coded nine-track tape. 

Because only 63 characters can be represented in seven-track even parity, one of the 64 
display codes is lost in conversion to and from external BCD code. The following shows the 
differences in conversion depending on the character set (63 or 64) which the system uses. 
The ASCII character for the specified character code is shown in parentheses. The output 
arrow shows how the 6-bit display code changes when it is written on tape in external BCD. 
The input arrow shows how the external BCD code changes when the tape is read and converted 
to 6-bit display code. 




63-Character Set 



6 -Bit Display Code 


External BCD 


6 -Bit Display Code 

00 


16 (%) 


00 

33 (0) 

Output 

12 (0) 

Input 

33 (0) 

63 (:) 


12 (0) 


33 (0) 



64-Character Set 



6 -Blt Display Code 


External BCD 


6 -Bit Display Code 

00 (:) 


12 (0) 


33 (0) 

33 (0) 

Output 

12 (0) 

Input 

33 (0) 

63 (%) 


16 (%) 


63 (%) 


If a lowercase ASCII or EBCDIC code is read from a nine—track coded tape, It is converted to 
its uppercase 6-bit display code equivalent. To read or write lowercase ASCII or EBCDIC 
characters, you must assign the tape in binary mode and use FCOPY to read or write the tape. 

Tables A-4 and A-5 show the character set conversion for nine-track tapes. Table A-4 lists 
the conversions to and from the 7-bit ASCII character code and 6-bit display code. Table 
A-5 lists the conversions between the EBCDIC character code and the 6-bit display code. 

Table A-6 shows the character set conversions between external BCD and 6-bit display code 
for seven-track tapes. 


A-12 
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Table A~4, Nlne~Track ASCII Coded Tape Conversion 



7-Bil 

ASCII 

6-Bit 

Display 

Code 

7-bit ASCII 

6-Bit 

Display 

Code 

Code 


Code 



Code 

Code 


Code 




(Hex) 

Chart 

(Hex) 

Chartt 

Char 

(Octal) 

fHex) 

Chart 

(Hex) 

Chartt 

Char 

(Octal) 

20 

space 

00 

NHL 

space 

55 

3E 

> 

IE 

RS 

> 


21 

1 

7D 

} 

\ 

66 

3F 

? 

IF 

US 

? 


22 


02 

STX 

It 

64 

40 

@ 

60 


@ 


23 

# 

03 

ETX 

# 

60 

41 

A 

61 

a 

A 


24 

$ 

04 

EOT 

$ 

53 

42 

B 

62 

b 

B 


25 

X 

05 

ENQ 

z 

63 

43 

C 

63 


c 

03 

25 


05 

EHQ 



44 

D 

64 

d 

D 

04 

26 

& 

06 

ACK 

& 

67 

45 

E 

65 

e 

E 

05 

27 

' 

07 

BEL 


70 

46 

F 

66 

f 

F 

06 

28 

( 

08 

BS 

( 

51 

47 

G 

67 

g 

G 

07 

29 

) 

09 

HT 

) 

52 

48 

H 

68 

h 

H 

10 

2A 

* 

OA 

LF 

* 

47 

49 

I 

69 

1 

I 

11 

2B 

+ 

OB 

VT 

+ 

45 

4A 

J 

6A 

j 

J 

12 

2C 

t 

OC 

FF 

> 

56 

4B 

K 

6B 

k 

K 

13 

2D 

- 

OD 

CR 

- 

46 

4C 

L 

6C 

1 

L 

14 

2E 

• 

OE 

SO 


57 

4D 

M 

6D 

m 

M 

15 

2F 

/ 

OF 

SI 

/ 

50 

4E 

N 

6E 

n 

N 

16 

30 

0 

10 

DLE 

0 

33 

4F 

0 

6F 

0 

0 

17 

31 

1 

11 

DCl 

1 

34 

50 

P 

70 

p 

P 

20 

32 

2 

12 

DC2 

2 

35 

51 

Q 

71 

q 

Q 

21 

33 

3 

13 

DC3 

3 

36 

52 

R 

72 

r 

R 

22 

34 

4 

14 

DC4 

4 

37 

53 

S 

73 

s 

S 

23 

35 

5 

15 

NAK 

5 

40 

54 

T 

74 

t 

T 

24 

36 

6 

16 

SYN 

6 

41 

55 

U 

75 

u 

U 

25 

37 

7 

17 

ETB 

7 

42 

56 

V 

76 

V 

V 

26 

38 

8 

18 

CAN 

8 

43 

57 

W 

77 

w 

w 

27 

39 

9 

19 

EM 

9 

44 

58 

X 

78 

X 

X 

30 

3A 

: 

lA 

SUB 

: 

00 

59 

Y 

79 

y 

Y 

31 

6-Btt display code 00 is undefined at sites usine 1 

5A 

Z 

7A 

2 

z 

32 

the 

63-£ba»cter set* 




5B 

[ 

1C 

FS 

[ 

61 

3a 

* 


SDB 1 

1 : 

63 

5C 

\ 

7C 

1 

\ 

75 

3B 





77 

5D 

] 

01 

SOH 

1 

62 

3C 





72 

5E 


7E 

** 


76 

3D 





54 

5F 

_ 

7F 

DEL 

— 

65 


Twhen these characters are copied from/or to a tape, the characters remain the same but the codes change 
from one code set to the other. 

ttThese characters do not exist In 6-blt display code. Therefore, when the characters are copied from a 
tape, each 7-blt ASCII character Is changed to an alternate 6-blt display code character. The 
corresponding codes are also changed. Example: When the system copies a lowercase a, 61if, from tans 
It writes an uppercase A, Olg. 

tttA 6-bit display code space always translates to a 7-bit ASCII space. 
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Table A—5. Nine—Track EBCDIC Coded Tape Conversion 


EBCDIC 

6-Bit 

Display 

Code 

EBCDIC 

6-Bit 

Display 

Code 

Code 

(Hex) 

Chart 

Code 

(Hex) 

Chartt 

Chartt 

Code 

(OcVal) 

Code 

(Hex) 

Chart 

Code 

(Hex) 

Chartt 

Char 

Code 

(Octal) 

40 

Space 

00 

NUL 

Space 

55 

C4 

D 

84 

d 

D 

04 

4A 

i 

1C 

IFS 

[ 

61 

C5 

E 

85 

e 

E 

05 

4B 


OE 

SO 


57 

C6 

F 

86 

f 

F 

06 

4C 

< 

CO 

{ 

< 

72 

C7 

G 

87 

s 

G 

07 

4D 

( 

16 

BS 

( 

51 

C8 

H 

88 

h 

H 

10 

4E 

+ 


VT 

+ 

45 

C9 


89 

i 

I 

11 

4F 

1 

DO 

} 

j 

66 

D1 


91 

j 

J 

12 

50 

& 

2E 

ACK 

& 

67 

D2 


92 

k 

K 

13 

5A 

1 

01 

SOH 

] 

62 

D3 


93 

1 

L 

14 

5B 

$ 

37 

EOT 

$ 

53 

D4 

M 

94 

ID 

M 

15 

5C 

* 

25 

LF 

* 

47 

D5 

N 

95 

n 

N 

16 

5D 

) 

05 

HT 

) 

52 

D6 

0 

96 

0 

0 

17 

5E 


27 

ESC 


77 

D7 

P 

97 

p 

P 

20 

5F 


A1 

*• 


76 

D8 

Q 

98 

q 

Q 

21 

60 

- 

OD 

CR 

- 

46 

D9 

R 

99 

r 

R 

22 

61 

/ 

OF 

SI 

/ 

50 

EO 

\ 

6A 

1 

\ 

75 

6B 


OC 

FF 


56 

E2 

S 

kl 

s 

S 

23 

6C 

z 

2D 


7. 

63 

E3 

T 

A3 

t 

T 

24 

«C 



m 

spacetH 

55 

E4 

U 

A4 

u 

U 

25 

6D 


07 

DEL 


65 

E5 

V 

A5 

V 

V 

26 

6E 

> 

IE 

IRS 

> 

73 

E6 

W 

A6 

w 

w 

27 

6F 


IF 

lUS 


71 

E7 

X 

A7 

X 

X 

30 

7A 

• 

3F 

SUB 

• 

00 

E8 

Y 

A8 

y 

Y 

31 

6-Bl 


«od« 00 i* ma»S 

l»ed AC using 

E9 

Z 

A9 

Z 

Z 

32 

the 

bl-charurter see 




FO 

0 

10 

DLE 

0 

33 

7A 

} 

SF 



63 

FI 

1 

11 

DCl 

1 

34 

7B 

7C 

7D 

7E 

7F 

Cl 

C2 

C3 

tl 

A 

B 

C 

03 

79 

2F 

ID 

02 

81 

82 

83 

ETX 

\ 

BEL 

ICS 

STX 

a 

b 

c 

# 

! 

tl 

A 

B 

C 

60 

74 

70 

54 

64 

01 

02 

03 

F2 

F3 

F4 

F5 

F6 

F7 

F8 

F9 

m 

12 

13 

3C 

3D 

32 

26 

18 

19 

DC2 

TM 

DC4 

NAK 

SYN 

ETB 

CAN 

EM 


35 

36 

37 

40 

41 

42 

43 

44 


tWhen these characters are copied from/or to a tape, the characters remain the same (except EBCDIC codes 
4A, 4F, 5A, and 5F) but the codes change from one code set to the other, 
t'txhese characters do not exist in 6-bit display code. Therefore, when the characters are copied from a 
tape, each EBCDIC character is changed to an alternate 6-bit display code character. The corresponding 
codes are also changed. Example: When the system copies a lowercase a, 81i6, from tape, it writes an 
uppercase A, 01g. 

Tit All EBCDIC codes not listed translate to 6-bit display code 55g (space). A 6-bit display code space 
always translates to an EBCDIC space. 
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Table A-6. Seven-Track Coded Tape Conversions 




6-Bit 




6-Bit 



Display 




Display 

Be ternal 

ASCII 

Code 


Bctemal 

ASCII 

Code 

BCD 

Character 

(Oc tal) 


BCD 

Charac ter 

(Octal) 

01 

1 

34 


40 


46 

02 

2 

35 


41 

J 

12 

03 

3 

36 


42 

K 

13 

04 

4 

37 


43 

L 

14 

05 

5 

40 


44 

M 

15 

06 

6 

41 


45 

N 

16 

07 

7 

42 


46 

0 

17 

10 

8 

43 


47 

P 

20 

11 

9 

44 


50 

Q 

21 

12t 

0 

33 


51 

R 

22 

13 


54 


52 

» 

66 

14 

tt 

64 


53 

$ 

53 

15 

@ 

74 


54 

* 

47 

16t 

% 

63 


55 


70 

17 

[ 

61 


56 


71 

20 

Space 

55 


57 

> 

73 

21 

/ 

50 


60 

+ 

45 

22 

s 

23 


61 

A 

01 

23 

T 

24 


62 

B 

02 

24 

D 

25 


63 

C 

03 

25 

V 

26 


64 

D 

04 

26 

W 

27 


65 

E 

05 

27 

X 

30 


66 

F 

06 

30 

Y 

31 


67 

G 

07 

31 

Z 

32 


70 

H 

10 

32 

] 

62 


71 

I 

11 

33 

» 

56 


72 

< 

72 

34 

( 

51 


73 

• 

57 

35 


65 


74 

) 

52 

36 

)? 

60 


75 

\ 

75 

37 

& 

67 


76 


76 





77 

9 

77 

tAs explained previously 

in this 

section, corversion 

of these codes 

depend s 

on v^ether the tape Is being 

read 

or written. 





60459680 C 


.5 




DtAGNOSTIC MESSAGES 


B 


This appendix contains an alphabetical listing of the messages that may appear in your 
dayfile. Lowercase characters are used to identify variable names or fields. All messages 
are sorted according to the first nonvariable word or character. Messages beginning with 
special characters (such as hyphens or asterisks) are sorted as if the special characters 
were not present. For example, the message 

filename ALREADY PERMANENT. 


is listed with the messages beginning with A, and the message 
****ENDING SUPPORT OF LFM FUNCTION nnB. 
is listed with the messages beginning with E. 

Dayfile messages usually issued only to COMPASS programs are listed in appendix B of Volume 
4, Program Interface. 

If you encounter a diagnostic or informative message that does not appear in this appendix, 
the NOS Version 2 Diagnostic Index. This publication catalogs all messages produced 
by NOS and its products and specifies the manual or manuals in which each message is fully 
documented. ® ^ 

All pages are at revision level L (without change bars). 


60459680 L 


B-1 


MESSAgE 


SICMIFICAIICE 


ACTION 


AOUTIWE 


AtSC. SC. 

cad ACCEf»TED. . 

ACCESS CATECORIES NOT VALID FOE JOS. 

ACCESS DENIED • SECURITY CONFLICT. 
ACCESS LEVEL NOT VALID FOR FILE. 


ACCESS LEVEL NOT VALID FOR FILE Vil 
AT nnn. 

ACCESS LEVEL NOT VALID FOR JOB. 


ACCESS LEVEL NOT VALID FOR JOB. f1T«n«n« 
AT nnn. 


An informative mossago indicating tha 
initial sarviea class of your job. 

sc Sarviea class 

Tfia natMork has aceaptad your terminal 
definition eotemand cmd. 

You attempted to use tha SETFFAC command 
or macro to set one or mere permanent file 
access categories for which you are not 
validated. 


You do*net have access to this account. 


One of the following occurred: 

You attempted to save a local file 
using an access level for the 
permanent file that is net valid for 
the device on which the local file 
resides. 

You attempted to define an existing 
local file as a direct access 
permanent file using an access level 
for the permanent file that is not 
valid for the device on which the 
local file resides. 


The access level of the job is net valid 
for the device on which the file filename 
resides■ 


One of the following occurred: 

' You attempted to save a local file 
at an access level that is net valid 
for your job. 

*■ You attempted to define an existing 
local file as a direct access 
permanent file at an access level 
that is net valid for your job. 

You attempted to set an access level 
for a permanent file that is net 
valid for your job using the SETPFAL 
command or macro. 

The access level specified for file 
filename is not within the job 
validations. 


None. 


None. 


Retry using a sat of 
access categories for 
which you are validated 
and that is valid for 
your job. 

Contact your site 
adminiSt rat or. 

Retry using an access 
level for the permanent 
file that is not lower 
than the access level of 
the local file. 


None. You may not 
access this file 
while your job is at 
the current access 
level. 

Retry using a valid 
level. 


None. You may not 
access this file 
while your job is at 
the current access 
level. 


CLASS 

CCF 

pwm 

XAFEX 

FFM 


IMS 

FFM 


IMS 




MESSAGE 

SIGNIFICANCE 

ACTION 

ROUTINE 

ALL EQ>S CHECKPOINTED. 

RECOVEKV ABORTED. 

In th« procpss of Aborting a CM rocev«ry. 

1CK WAS CAllod to proeoss All eutstonding 
chocRpeint roquosts. 

Level o deadstart is 
requir ad. 

1CK 

filAnam* ALREADY PERMANENT. 

You hAvs AlroAdy sAvod or dofinod a fils 
with th« noniA spoeifiod. 

save or define file 
using different file 
nemo or purge existing 
file. 

FFM 

ALTERNATE STORAGE ERROR. 

It Is not possiblo to drop tho dish spACo 
ASSoeiAtod with th« spoeifiod porniAnAnt 
fit*, sines An orror exists on tho 

Alternoto storAgo copy of tho filo. 

Inform site analyst. 

FFM 

APPENDED ^• typp / namp 

Tho record with typo And nAmo on tho 
roplAcomont filo was not inAtehod; it nos 
boon oppondod to tho now filo. A option 
so lootod. 

None. 

COFYL 

APPLICATION NAME IS REOUIREO. 

You ontorod on APPSW eoamiAnd thot did not 
specify A soeondAry opplicAtion. 

Reanter tha eemmand with 
tha appl parameter 
specified. 

TLX 

APPLICATION NOT PRESENT. 

Tho roquostod Applicotion is currently net 
AvoilAblo for use. 

Enter the name of 
another application or 
leg off and try later. 

NETVAL 

APPLICATION RETRY LIMIT. 

Four unsuccessful Attempts wore isodo to 
enter • logoi Applicotion name. After which 
tho torminol was diseonnoetod. 

Check tho accuracy of 
tho entry. If problems 
persist, contact 
installation personnel. 

NETVAL 

ARC. ERROR. 

Your pregron spoeifiod incorrect 

Arguments when it collod LDR to lood on 
overlAy. 

Correct and retry. 

1AJ 

ARGUMENT ERROR. 

Tho eernmond syntax is incorrect. 

SpecificAtion of duplicoto pAromotors 
fnero then ono occurroneo of o koywerd) 
or noutuAlly exclusive pAremotors (such 

AS MT/NT. CB/CK. Fl/L. R/W. PDtR/PO>W. 
and so forth) is not Allowed on a tape 
assignment commend. The address 
pAramoter on OMPECS, OMDECS, LBC. LOC. 

PBC. or W8R must be numeric. 

Reenter commend using 
the correct parameters 
and syntax. 

COFYB 

CFMEM 

FOTO 

LDl 

L072 

RECOVER 

RESEX 

SUBSYST 

ARGUMENT ERRORS. 

The ENOUIRE command's syntax is incorroct. 

Check parameters on 
eemmand and ratry. 

ENQUIRE 

ARITHMETIC ERROR. 

An arithmetic hardware error occurred. 

Inform site analyst. 

RECLAIM 

ARITHMETIC INDEFINITE. 

Tho CPU flooting-point arithmetic unit 
Attomptod to uso an indefinite operand. 

Analyse the job 
output and dumps to 
determine the cause 
of the error. 

1AJ 

ARITHMETIC OVERFLOW. 

Tho CPU flooting*peint arithmetic unit 
received an operand too large for 
computet ion. 

Anelyse the job 
output end dumps to 
determine the cause 
of the error. 

1AJ 

ARITHMETIC UNDERFLOW. 

Tho CPU flooting-point arithmetic unit 
roceived an operand tee small for 
computet ion. 

Analyse the job 
output end dumps to 
determine the cause 
of the error. 

1AJ 

ASL * nnnnnn, USL < nnnnnn. 

Informative message issued after a SETASL 
or SETJSL command indicating the current 
value of the account blocR SRU limit 
(ASL) and job stap SRU limit (USD. 

None. 

CONTROL 

ASL s nnnnnn. JSL s nnnnnn. 

Informative mossege issued efter a SETASL 
or SETUSL commend indicating the current 
value of the eceount block SRU limit 
(ASL) end the Job stop SRU limit (JSL). 

None. 

CONTROL 

• St. ASSIGNED TO filanania. 

Informative message specifying EST ordinal 
est was assigned to file filename. 

None. 

LFM 

ttast. ASSIGNED TO fllAnaraa. 

Equipment type tt with EST ordinal ost was 
assigned to filo filonamo. 

None. 

LFM 

jsn ASSIGNS EXCEED DEMANDS. 

Systam orror. The resources actually 
assigned to the job with the specified job 
sequence nemo exceed the resources demanded 
on a RESOURC command. 

Inform site analyst. 

RESEX 

ATTRIBUTE COMMANDS MUST BE OF ONE NETWORK 
TYPE. 

Tormina! attributes unique to NAM/CCP and 
to NAM/CDCNET woro spoeifiod on the seme 
TRMDEF commend. 

On the TRMDEF command. 
Cheek to ensure that ell 
terminal attributes ere 
supported by your 
network type. 

TRMDEF 

BAD CATALOG/PERMIT SECTOR. 

PFM has eneeuntered a catalog or permit 
sector which dees net hove e valid sector 
length. This indicates corruption of 
system areas on disk. 

Inform site analyst. 

If many of these errors 
occur, tho site analyst 
should perform e full 
PFDUMF. total INITIALIZE, 
and full FFLOAD on the 
device. 

FFM 

BAD DATA IN OLDPL HEADER. 

The file is a program library but is 
net of a recognisable format. 

Try rebuilding the file i 
possible. Inform site 
analyst. 

if ITEMIZE 


•04StttO L 





MESSAGE 


SICNIFICAWCE 


ACTIOW 


AouTme 


•AO FCOFY CONVERSION TABLE. 

nnnnnnnnnn BAO FORMAT BLOCKS. 

BINARY SEO. ERROR. RECxxxx COyyyy. 

BLANK LABELS DO NOT VERIFY. 

• LANK TAFE. fil«nani« AT addrAss- 

BLOCK NUMBER nnnnnn. fildnsniA AT «ddr«ss. 

BLOCK SeOUENCE ERROR, f^lAndMC AT addrASs. 

BLOCK SIZE NOT APPLICABLE. 

BLOCK SIZE TOO LARGE ON filanaa. 

SLOCK SIZE TOO SMALL ON fnonam. 

BLOCK TOO LARGE. «i1 AnanA AT addPASS. 

BOT/EOr ENCOUNTERED. filananA AT addrASS. 

BREAKPOINT CONDITION. 

BREAKPOINT WITHIN DEBUGGER. 

BUFFER ARC. ERROR . 

BUFFER ARGUMENT ERROR. filAfiaoiA AT addrASS. 


BUFFER ARGUMENT ERROR ON fflAnana AT 
addrass. 


FCOPY tablAS ara in orrer. 


Blocks net lAAating X or Sl^eedad 
eenvArsien rAquiranants hava baan 
aneeuntarad on input. 


Write a FSR and ineluda 
support mataria Is to 
allow COC to duplicate 
the preblam. 

Chaek tape Fermat For 
errors. 


A binary command was Found to ba out oF Examine saquaneing oF 

saquancA and the job was tarminatad without binary dock and cerraet 
EXIT processing. Error is on command yyyy error. 

oF record xxxx. 


Tna tape labels written on the blank tape 
could not ba variFiad. probabiy due to 
hardware Failure. 


Raquast that the 
operator blank label 
the tape using a 
diFFerent tape drive. 


A blank tape was read. Blank tape is Ensure correct tape is 

doFined as mere than 2S Feat oF erased tape. spaciFied on command. 


A tape error has occurred at block Nona, 

nnnnnn. A second massage generally 
accompanies this message, giving mere 
detail as to the nature oF the error. 


The block length recorded in the File did 
not match the length oF the block read or 
the block number recorded in the File did 
net match the system block count (this 
message applies to 1 Format tapes only). 


Either the CC or BS parameter was spaciFied 
on a COPY ceoieand For which neither the 
input nor output File was an S or L Fermat 
tape or the CC parameter was spaciFied on a 
COPYB command without the E or B conversion 
parameter speciFied. 

S tape block site exceeds maximum For that 
Format IIOOOB) and COPY or character count 
For E or B tape COPYB exceeds maximum For 
that format (5120 characters). 

On P to F tape copy, the maximum Frame 
count For the First File exceeds that oF 
the second File. On S and L tapa copy, 
block siso is loss than noisa siso. On E 
and B tapa. block site is loss than the 
corresponding S tape noise site. 


The tape being read eentainad a data block 
greeter in site then thet ellewed by the 
specified Format or by your spoeiFicetion. 


Indicatos en ebnormel tepo position. 


The job executed en address for which e 
breakpoint was requested by the system. 

you specified a breakpoint address within 
the break pointer itself. 

CM address in call is net less then the 
Field length minus the word count; buffer 
extends pest the job’s Fiold longth. 


For tape operetiens. this message indicates 
one of the following: 

' FET less then 7 words long for $/l format 
• MLRS greeter then leoo ectel For s Format 
FOSMF issued end no HDR1 label Found in 
FET or extended label buffer 

Refer to Volume 4 of the NOS Version 2 
Reference Set. 

IF the message was caused by the FCORY 
commend, it Indicates that the product of 
the Fixed line length (FL parameter) end 
lines per block (LB paremoter) was 
greater then 2B40. 

a buffer pointer did not conform to tho 
Following constraints: 

FIRST .LE. IN 
FIRST .LE. OUT 

IN AND OUT .LT. LIMIT .LE. FL 

Refer to Volume 4 of tho NOS Version 
2 RoForonco Sot. 


Ensure accuracy of 
Format paramotor (F) 
and label parameter 
(LB) en command or 
macro. IF problem 
still exists, clean 
tape drive or use a 
now tape. 

Refer to the COFV or 
COFVB commend 
description, correct the 
command, end retry. 


Reduce the block size or 
ehereetor counts. 


Incroeso block site so 
that it is greeter then 
the noise site. On F to 
F tepo copy, ineroese 
output File block siso 
so it is greeter then 
the block sise of the 
input File. 

Ensure eecureey ef 
Fermat parameter (F) 
end label parameter 
(LB) commend or 
macro. IF tho 
problem still exists, 
clean the tape drive 
or user a new tape. 

Inform site analyst if 
persistent. 

Contact evSER 
Software Support. 

Correct address end 
reenter cenHUind. 

veriFy thet the 
eperetien does net 
reference an addrass 
bayend and ef buFFor 
or job's Field 
longth. 

Examine program to 
dotormino arrer. 


Examine program to 
dotormina arrer in 
buffer pointers. 


FCOPV 

COFVB 

1AJ 

BLANK 

1MT 

1MT 

1MT 

COFYB 

COFVB 

COFYB 

1MT 

IMT 

1AJ 

DEBUG 

1AJ 

IMT 

FCOFY 


IMS 
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MESSAGE 


SIGNIFICANCE 


ACTION 


NOOTINE 


SUFFEN CONTROL WORD ERROR. 


BUFFER CONTROL WORD ERROR, Fil«nam« AT 
«dcir«ss • 


BUFFER OVERFLOW • ALL FILES LISTED BUT NOT 
SORTED. 


BUFFER SFACE ERROR (TOV). 


pFn BUSY. 

CALLING JOB MAY NOT OROF ITSELF. 

CANNOT ATTACH/GET FILE F##fF#f-FlLE 
SKIFFED. 


CANNOT CHANCE CLASS OF ON-LINE JOB. 

CANNOT CHANCE CLASS OF SUBSYSTEM. 

CARD READER ERROR. 

CATALOG ARGUMENT ERROR. 

CATALOG FILE NAME CONFLICT. 

CATLIST COMFLETE. 

CCLIOO- SEFARATOR FOLLOWING VERB MUST BE 
COMMA OR LEFT PARENTHESIS 

CCL101- LAST NON-BLANK CHARACTER MUST BE 
SEFARATOR 


CCL102- EQUAL SIGN MUST FOLLOW FIRST 
SYMBOLIC NAME 


CCL103- COmHAND INCOMPLETE 


CCL104- EXPRESSION AND COMMAND TERMINATED 
BY tArrstnater 


L 


Oayfila iNASSaQA indicating that tha word 
count in tha disk linkage is graatar than 
1008. 


Either an attempt was made to write a block 
smaller than the noise size on an S, L, or 
F Fermat tapa. or a control word error 
occurred in a write (such as bad byte 
count 1. 

InFermative output file massage indicating 
that you have mere permanent files than can 
fit in the sort buffer. The system listed 
all of the files but net in alphabetical 
order. 

Internal error. 


The specified direct access file is 
currently attached in an incompatible 
mode or is already being accessed by 
A09S users in your specified mode (R, 
RA, RU. or RM). 

You attempted to drop yeur current jOD. 


An error occurred when attempting to get 
or attach file FFFFfff. The File may 
have been attached or purged by another 
job. 


You extended a CLASS eoiweand with a JSN 
parameter that attempted to change the 
service class of an online job. You 
cannot use the JSN parameter to change the 
service class of an online job. 

The service class of a job executing at the 
subsystem service class cannot be changed. 

Job was terminated without exit processing. 

The syntax of the CATALOG command is 
ineorrect. 


The same file was named as the file to be 
cataloged and as the file onto which the 
catalog is written. 

Informative message indicating a successful 
completion of the CATLIST command. 


Take a deadstart dump. SLL 

write a PSR. and sand 
the dump and PSR to CDC 
along with any support 
materials which will 
allow COC to duplicate 
tho preblaa. 

Examine program to 1MT 

datormina arrer. 


None. CATLIST 


Submit a PSR with 
information on how 
to dupiicato tha 
problam. 

Raissua ATTACH until 
fi1 a bacomas 
aval labia or issue 
ATTACH Specifying W8 
or NA option. 

Do not attempt to drop 
your current job. 

Check your dayfile 
for a specific error 
message. If you do 
not find ena. inform 
tho sita analyst. 

It's normal for this 
massaga to appear, 
raferancing the 
RECLAIM database, 
during a DUMP 
eparation. 

None. 


lEDXT 


PPM 


DROP 

RECLAIM 


CLASS 


None. 


CLASS 


Resubmit job. tAJ 

Cheek tho CATALOG CATALOG 

command description and 
correct the command. 

Change one of the file CATALOG 

names on the CATALOG 
coiMsand. 

None. CATLIST 


Separator following vorb (directive name) 
must bo a comma or a left parenthesis. 


Last Character string of line was net 
fel lowed by a separator or a terminator. 


The first parameter in a SET command is a 
symbolic name to be aguatad. An equal sign 
must fellow the symbolic name. 


A terminator was dataetad immodiately 
following the command name. 


An expression or a command name was 
fellowad by a command tarminater (period 
or right parenthesis) instead of a comma. 
Any of tha following conditions may 
produce this error. 

• The label string parameter was omitted. 

• A relational or logical operator was 
dolimitad by a period on loft side only. 

• An unmatched right parenthesis appeared 
in expression. if the sepereter 
following a command nawo was a left 
paranthosis, an unmatched right 
parenthesis may appear matched. Per 
example, WHILECRIFRE)>3. LABEL, is 


Change separator CCL 

following vorb to a 
ceiMia or a left 
parenthesis. 

To terminate command, CCL 

make last nonblank 
charaetar a period or 
right parenthesis. To 
continue command on next 
commend or line, make 
last nenblank character 
a valid separator. 

Change separator CCL 

following tha symbolic 
nemo to an equal sign. 

Equal sign must be 
followed by an 
expression. 

Cnaek command format CCL 

(refer to section •) 

and rewrite command, 

using a comma 

or loft paronthasis 

after the coimaand name. 

Implement the action CCL 

that applies to the 
eohditien that 
produced tha error. 

- Place a comma after 
tho expression or the 
command name and add 
a label paramatar. 

- Delimit operator with 
periods on both sides. 

• If error was caused 
by a misleading laft 
parenthesis following 
tha command name, add 


B-l 




WtSSACg 


siCMiriCAiieE 


ACTIOW 


KOUTlMg 


CCL120- 


ALL COMMANPS SKIPPED 


XXKKXX 


LABEL STRING MUST BEGIN WITN 
ALPHA CHARACTER 


CCL123> ALPHANUMERIC LABEL STRING 
REQUIRED 


CCLt24> PRECEDING ERR MSG. APPLIES TO 
FOLLOWING 


CCL125' NUMBER OP COtiN4AND$ SUPPRESSEDsx 


CCL12S- 


COMMAND TERMINATOR MUST FOLLOW 
LABEL 


CCLt27- LABEL STRING EXCEEDS XX 
CHARACTERS 


CCL1SO- EXPRESSION CONTAINS INCORRECT 
OPERATOR X 


CCLISt* EXPRESSION FORMAT ERROR (IN FILE 
FUNCTION) 


CCL152> 


POORLY FORMED FUNCTION • 
NUM. SS. STR. STRB, STRO) 


or. LEN. 


CCL1S3- INCORRECT FUNCTION CALL (WITHIN 
FILE FUNCTION) 


CCL164> INCORRECT EXPONENT 


t«rmln«tQd by right paronthASis. 

This ni«ss«g« is infermAtiv* And is issuAd 
in conjunction with massaoa CCL123. 


In proeoss of shipping, ond of coimAnd 
roeerd was roAChod. Any of tho following 
conditions Moy preduco this orror. 

• An IFE. SKIP, or ELSE oxprossion was 
fAlSA And no ENOIF conniAnd tArninAtod 
rosultAnt ship. 

A WHILE oxprossion was fAlso And no ENOW 
conimAnd tArminotod rosultAnt ship. 

An ENOW conuRAnd was net procodAd by a 
WHILE eoMMAnd. 


A eoflHXA iRHaodiotAly 
After the coAwiAnd 
none. Othorwiso, 
rochoeh All 
poronthASAS end moteh 
unoAtehAd right 
pAronthAsis. 

ImpiAmont the Action 
thot Applies to the 
condition thot 
produced the error. 

• Either odd on ENDIF 
coiwMnd with a 
iRAtehing lAbel string 
or eorreet existing 
ENOIF eoAMiAnd. 

Either odd on ENOW 
coMiMind with A 
tsAtehing lAbel string 
or eorreet existing 
ENOW eoiMAnd so thot 
WHILE end ENOW lebel 
strings moteh. 

Preeode ENOW eomisAnd 
with A WHILE eoAHMnd. 


The first chArocter of a lebel string must 
not be numeric. 


The commAnds ELSE, ENOIF, ENOW. SKIP, ond 
WHILE require a lebel string perAmeter. 
This messege is issued in conjunction 
with the messege CCL104. 


Chonge lebel string to a 
lebel string of 1 to 7 
Alphenumerie cherAeters, 
beginning with on 
Aiphebetic cherecter. 

Refer to messege 
CCL104 for CAUSA end 
suggested Action. 


Oeyfile messAge which precedes CCL124 is Refer to the error 

on error messege which was ceused by the messege which 

commend printed After CCL}24. precedes this in the 

deyfiie for ceuse end 
suggest ed ection. 


A commend which the system is printing from None. 

en internel buffer continued ever more 

lines of input then buffer sixe. The 

system prints the first three lines end 

then prints this messege to indicete the 

number of lines suppressed, x. Remeining 

lines of the commend fellow this messAge. 


Either of the following conditions mey 
produce this error. 

• A lebel string is lest perAmeter on on 
ELSE, ENOIF. ENOW, IF, SKIP, or WHILE 
commend. It must be followed by a 
period or a right perent hosts. 

*■ An expression eenteined a eemme, end the 
chAreeter string thot followed was 
A ssumed to be a lebel string. 


The lebel string perAmeter en en 
ENDIF, ENOW, IFE. SKIP, or WHILE 
greeter then xx cherecters. xx 
meximum number of cherActers def 
instellet ion. 


ELSE , 
commend 
i s t he 
ined by 


X is not A VAlid operetor in the preceding 
eemmend. 


The fermet of the expression is ineerr 
The prebeblA ceuse is use of cemmes or 
unemtehed left perenthesis within en 
expression. If error was detected wit 
FILE function, IN FILE FUNCTION is ine 
in messege. FILE function must be of 
FILE(fileneme,exp), where exp is e vel 
function or symbolic neme. 


ect. 


h i n A 
luded 
form 
id 


You mede one of 


the following errors: 


Seperetor After function nemo is net a 
loft perenthesis or function is net 
termineted by e right perenthesis. 
Cherecter string ovelueted by function 
conteined speciel cherecters but was net 
$-delimited. 


Implement the Action 
thet iRAtehes the error. 
Terminete cemmend 
with A period or e 
right perenthesis. 
Either remove comrne 
or replAce it with e 
left perenthesis, 
depending en neture 
of error. 

Chenge lebel string on 
Any coiMNind it eppeers 
to A lebel string with 
XX or fewer Alphenumerie 
cherecters. 

If X is pert of A 
cherecter string, 
B-'delimit ehAreetor 
string. If x is en 
intended epereter, refer 
to section s for e list 
of VAlid opereters. 

Chech perentheses end 
metch unmetehed loft 
perenthesis or remove 
excess coeMes from FILE 
funetion. 


Implement the Action 
thet RMtehes the 
error. 


Correct fermet of 
function. 
S'delinit speciel 
Cherecters. 


The LEN, FILE, NUM. STR, STRB OR STRO function.Restructure the 
or SS symbolic nemo eppeers within a FILE expression so thet 

function. the function or 

symbolic veluo in 
question is net 
within A FILE 
function. 


A negetive exponent in en expression is 
ineerrect. 


Remove minus sign 
preceding exponent. 


CCL 


CCL 


CCL 


CCL 


CCL 


CCL 


CCL 


CCL 


CCL 


CCL 


CCL 


CCL 
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MESSAGE 


SICttlFlCAWCE 


ACTION 


AOUTIHE 


CClfSS' OPERATOR OR OPERAND SEOUENCE 
ERROR 


CCL1S6- STRING TOD LONG 'Stmo 


CCL1S7> UNKNOWN NAME -Striig 


CCLISS-^ OPERATOR/TERMINATOR MUST FOLLOW 
FUNCTION (OT. FILE. LEN, NUM. STR. STR8. 
STRD) 


CCL1SS* FIRST PARAMETER INCORRECT IN SET 
COMMAND 


CCL1SO- NUMERIC OR LITERAL ILLEGAL (IN 
FILE FUNCTION) 


CCLISt> STACK OVERFLOW 


CCL162- PERIOD BRACKETED OPERATORS 
PREFERREO 


CCL163- SUBSYSTEM REFERENCE ERROR 


CCLTSA* PACE PARAMETER ERROR 


CCL18S* CONCATENATION MUST HAVE STRING 
OPERANDS 


You NAdA on« of th« following orrers: 

* Soquoneo of odjACont ogorators is 
ineorrAot. For owomplA. 3*/4 is not 
allowod. 

' An eporand is adjaeont to a loft or 
right paronthosis. ImpTiod 
nuttipiieation is not allowed. For 
oxanplA. 3(R*i) is incorrect. 


The listed character string (strng) is tee 
long. A character string leay not be 
longer then to characters, excluding $ 
delimiters for literals, unless it 
appears within the STR function. 

The alphanumeric character string strng is 
is not a symbolic name recognised by the 
Systam. 


A function was properly formed and 
positioned within a command, but it was net 
followed by an operator, separater, or 
terminator. 

The first parameter in the SET command was 
not one of the following symbolic names: 
DSC. EF, CFG, R1. R2. R3. RIG. or SS. 

The expression of a FILE function may 
contain only symbolic names defined for the 
funetion. 


Evaluation of an expression overflowed 
either operator or operand stack. 


Informative message indicating that a 
single character operator was used in an 
expression. (that is. > instead of 
.GT . ) . 

The system does not recognise the name 
associated with the symbolic name SS. 

An error was detected when setting the job 
default page size symbols PD. PS. PW. 


One or both of the operands for a string 
concatenation (//) were not within one of 
the string functions. 


Implement the action 
that matches the 
error. 

• Use parentheses to 
separate adjacent 
operators. 

• Use an operator to 
separate operand and 
parenthesis. 

Shorten character 
string to 10 
characters or less, 
or enclose it within 
the STR function. 

Replace strng with a 
valid symbolic name. 
Refer to section 8 for a 
list of valid symbolic 
names. 

Place an operator, 
separator, or terminator 
after function. 


Replace first parameter 
with a valid symbolic 
name. 

Remove numeric or 
literal character 
String. Refer to 
section 6 for a list of 
FILE symbolic names. 

Check expression for 
errors and correct. If 
no errors, either 
Simplify expression or 
break it apart so that 
two or mere commands 
have same effect as one. 

Use period bracketed 
operators. 


Refer to section S for a 
list of valid names. 

Cheek to see if the 
value in the expression 
is within the range of 
the symbol. 

Enclose the operand 
in question within 
an STR. STRB. or STRD 
funetion. 


CCL 

CCL 

CCL 

CCL 

CCL 

CCL 

CCL 

CCL 

CCL 

CCL 

CCL 



MgSSACg 


SlCWlPICAIiCE 


ACTICM 


ROUTIWE 


CCL207- PAOeCDURe NAMED teCIN IS 
INCORRECT 

CCi.211* SPECIFICATION EXCEEDS xx 
CNARACTERS 


CCL212* SEPARATOR INCORRECT strng s 


CCL213- END OP INFORMATION ON PROMPTED 
INPUT 


CCL214' NOT ENOUGH FL - CHECK aCCFL* 
IN *PPCOM« 


CCL230> PROCEDURE FILE NOT FOUND 


CCL23t- PROCEDURE MOT FOUND 


CCL232- PROCEDURE FILE IS RUSV 


CCL233' PROC HEADER MUST LEAD LIBRARY 

PARTITION/PNAME MUST BO PARTITION 
NAME 


CCL234* UNABLE TO LOCATE LIBRARY 
PARTITION - XXX 


CCL33S> FORMAL PARAMETER CT xx CHARACTERS 


CCL236- SPECIAL DEFAULT SPECIFICATION 
UNKNOWN 


CCL237- SEPARATOR FOLLOWING SECOND 
DEFAULT IS «/• 


CCL23S* FORMAL PARAMETER LIMIT xx 
EXCEEDED 


CCL23»>sPROeCOURC HEADER MUST BE 
TERMINATED BY A PERIOD 


CCL240-«MAY NOT APPEAR IN FORMAL PARAMETER 
NAME 

CCL24t- DATA FILE LFN EXCEEDS 7 
CHARACTERS > F11«n«a« 

CCL2$0- CONCATENATED STRING EXCEEDS XX 


A preeoduro nust not b« nomod BEGIN. 


THo voluo on a preeadura call or dafault 
valua on a preeadura haadar dfractiva is 
QPaatar tPan xx eharactsrs. xx is dafinad 
Py installation. 

s is an incerract saparator and strng is 
tha cftaraetar string that pracadas s. Any 
of tha following conditions produeas this 
arror. 

On a proeadura call, tha saparator 
praeading a fornal xayword or a 
positionally spaeifiad valua is not a 
eoHMia. 

Invalid saparator is part of a eharaetar 
string. If a valid saparator 
i anaad i at a 1 y pracadas incorract saparator 
S, tha string is null. 

OOATA, OFILE, or PPRIMARY has bOOn 
spaeifiad on tha proeadura call. 

Tha usar assignad input to a fila that is 
at tha and of information and CCL naads to 
prompt for a paramator. Tha INPUT fila 
probably contains faulty data. 

Thara is insuffieiont fiald langth to 
axacuta CCL whan cal lad by VALEX during 
prologue preeassing. This is caused by 
tha Symbol CCFL in PPCOM baing sat toe 
lew. 


Tha fila named on tha procedure call was 
not assignad to the job and the 
installation chose to inhibit automatic 
retrieval of a parmanant fila with that 
name. 

The local or permanent file indicated on 
the procedure call was found, but the 
system could net find the proeadura on the 
fila. 

The CCL ATTACH found a file busy status on 
the preeadura file. 


Tha name of the proeadura must match a 
partition in tha library where tha 
procedure resides. The preeadura header 
must be tha first entry in tha partition. 

Tha system could net find proeadura xxx, 
spaeifiad on tha eall'by>naraa coamiand. on 
tha currently defined library sat. 


Tha number of characters in a Neyword on 
tha preeadura header directive exceeds xx. 
as defined by installation. 

Tha number sign which specifies a 

special dafault option on the procedure 
header directive, must be followed by 
FILE, PRIMARY, or DATA. 


In form Naywerd>dafault1/default2/ on tha 
procedure header directive, tha second / is 
incorrect. 


The number of paramatars on tha proeadura 
header directive has axcaedad xx. as 
defined by installation. 


Tha procedure header directive was not 
terminated by a period, and no commands 
ware found after tha header directive. 


A keyword containing an asterisk was found 
on tha procedure header. 

Tha file name specified on a .DATA 
directive is longer than seven characters. 


Select another procedure CCL 
name. 

Specify a value with xx CCL 
or fewer characters. 


Implement the action CCL 

that applies to the 
condition that 
produced tha error. 

Change separator s to 
a comma. 

S^dalimit character 
string. 

• Remove eOATA, #FILE, 
or PPRIMARY from 
procedure call and 
specify it on procedure 
header directive. 


Correct the file CCL 

contents or supply tha 
CCL paramatars 
interactively. 

Modify the value of CCL 

CCFL to be greater 

than the FL required 

for tha CCLBRWE 

overlay of CCL. 

reassemble NOSTEXT 

and VALEX, and 

rabuiId tha NOS 

system. 


Cheek file name far CCL 

errors ond eorroet. If 
namo is eorraet, 
ratriave file prior to 
preeoduro call. 

Chack preeadura name for CCL 
arrers and eorraet. If 
name is eorraet. cheek 
file for preeadura. 

Clear fila busy CCL 

condition and rasubmit 
preeadura. 

RabuiId library with tha CCL 
preeadura haadar as tha 
first entry in tha named 
part it ion. 

Chack preeadura name for CCL 
errors and eorraet. If 
name is eorraet. cheek 
library for preeadura. 

Define a kaywerd with xx CCL 
or fawor eharaetors. 

If number sign is CCL 


part of a eharaetar 
string, anelesa the 
eharaetar string with 
dollar signs. If a 
spaeial dafault option 
is desired, fallow the 
number sign with either 
DATA, FILE, or PRIMARY. 

If / is part of CCL 

defaults, anelesa the 
character string with 
dollar signs. If net, 
either remove it or 
replace it with a 
comma or paried. 

Rameva paramatars from CCL 

procedure haadar 
diraetiva until xx or 
fewer paramatars remain. 

Terminate preeadura CCL 

header with a paried and 
add at laast one command 
to preeadura. 

Redefine the kaywerd CCL 

without any astarisks. 

Spaeify a shertar file CCL 

nama. 


Use of a right arrow |or the undarlina Rodueo number of linked CCL 

character in ASCII) produced a linked characters. 

string of more than xx characters or a 

string of xx enaraetars with a following 

separator. xx is equal to tP.SCL. 

fDafault is ISO). 


B>* 
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MESSAGE 


SICWIFICANCE 


ACTIOli 


RDOTIliE 


CC1251- DATA OmECTIVE SPECIFIED RESERVED FILE Th. fll. nan. that you spaciflao on a .DATA 

dir«cttVA Is • werKing f»l«. 

CCL2S2- PROCEDURE CONTAINS NO COMMANDS A procaouFa should contain at laast ona 

ceniMnd. 

CCL2S3- PAOC BODY STRING EXPANDS .GT . *x Aft.r p.r.IPPtPr substitution. • sinfll. 

eontiDuous string In tn« procoduro body Is 
lengor than th« maxlnuni lino longth. xx Is 
oqual to IP.SCL. (Dofoult is ISO). 

CCL2C1- ENOW WITH MATCHING LABEL FOUND ThO syStON oneount.r.d .n ENDW conniond in 

tno Job commond roeerd boforo finding « 
WHILE coiwnand with « matching labol 
string. A soarch Is initiatod for a 
eerrosponding WHILE command. If a WHILE 
command with a matching label string Is 
found and tha WHILE oxprassion is true, 
normal proeosslng centInuos with the 
command following the WHILE command. If 
the WHILE oxprosslen is false or If no 
WHILE command with a matching label string 
is found, the system skips all remaining 
commands In command record. 


CCL262- CONTINUING SEARCH, PRINT SKIPPED 
COMMANDS 

CCL263* EXTERNAL ABORT DURING BEGIN 

CCL263' EXTERNAL ABORT DURING ENDW 


CCL270- 


ERR IN CCL WORK FILES. 
JOB FILE 


REVERT TO 


CCL271- REVERT NOT ALLOWED WITHIN JOB 
FILE 

CCL273> INCORRECT REVERT PARAMETER > 
param 


CCL273- EXPECTING . OR ) AFTER REVERT,EX 


CCL300- NON-NUMERIC CHARACTER WITHIN 
NUMERIC TERM 


CCL303- B/9 DIGIT CONFLICTS WITH POST 
RADIX OF B 


To assist In Isolation of WHILE command 
errors such as CCL261, all skipped 
commands are printed in the job dayfile 
until the WHILE search is complete. 


An external abort during BEGIN processing 
occurred. Check the job dayfile to find 
where error occurred. 


An external abort occurred during the 
search for the while command. The abort is 
due to a DROP or RERUN command, an exceeded 
time limit, mass Storage limit, or extended 
memory iimit. 


An error was encountered in a file used by 
the system because of user manipulation of 
procedures or data. The system attempts to 
return to your assigned job file. If 
unsuccessful, the job terminates 
immediately. If successful, control goes 
to the EXIT command. 


A REVERT command cannot appear in commands 
of the job file. 

The parameter param was used on the REVERT 
eoimnand. The REVERT coimeand allows only 
ABORT. EX. or NOLIST as parameters. 

REVERT,EX. does not accept any ether 
parameters. The command must be terminated 
and a valid command must Immediately fellow 
the terminator. 

An element of an expression which begins 
with a numeric character cannot contain a 
nennumerle character, except B or D as a 
pest radix. 

An s or 9 Is Incorrect in an octal number. 


CCL303- LITERAL NOT TERMINATED 


CCL320* CORRECT 
CCL320- ENTER 


CCL321- expecting ( AFTER PARAMETERS ON 
HEADER 


CCL322- END HEADER WITH . OR USE ./ \ 
BEFORE PARAM 


CCL323- EXCESS PATTERNS/VALUES • PROC 
HEADER 


A literal which begins with a dollar sign 
was net terminated by a second dollar sign. 


This message precedes a system prompt for a 
PRTameter when a batch mode procedure call 
contains a parameter entry in error. 

In a parameter-promptIng procedure, the 
equal sign after a parameter name or 
description must be followed by a left 
parenthesis to indicate the start of a 
check 11 st. 

A parameter definition or the ■! after the 
procedure name must be followed by a 
period, comma, slant, or reverse slant. 

The sum of checklist values, patterns, and 
description text is too large {exceeded 
the Internal table sise of CCL. which is 
an Installation option). 


CCL32S«as 

RANGE MUST 

BE .GE.1 AND 

.LB.AO 

The range for the as checklist 
saro or greater than AO. 

patti 

CCL32C- 1 DR M MUST 
HEADER. 

FOLLOW FNAMEa 

ON 

The procedure name must be fel 
for interactive procedures or 

lowed 
by aM 





menu procedures. 


Select another file nemo. CCL 

None. CCL 

Rewrite the string using CCL 
fewer characters or 
f ewer concat enat ed 
strings. 

Cheek for a WHILE CCL 


command and if not 
present, add. If 
present, see if tVHlLE 
and ENDW label string 
match and are correct. 
If they match, place 
WHILE command before 
ENDW command. 


None . 


CCL 


Correct BEGIN command or CCL 
PRDC directive as 
indicated by dayfile. 

Cheek validation CCL 

limits. Modify job to 
fit within limits or ask 
site to increase the 
limits. 

Rewrite the job and/or CCL 

procedures to prevent 
manipulation of the 
system work flies. 


Remove REVERT command. CCL 


Replace parameter param CCL 

with a valid 
spec IfIcat ion. 

Correct command and CCL 

resubmit. 


Remove any nonnumerie 
characters other than a 
post radix B or D. 


CCL 


Remove any 9 or 9 if CCL 

the number is octal, 
or remove pest radix 
B If number Is 
decimal. 


Flace a second 
sign at end of 
string denoted 
1 Iteral . 


dollar CCL 

character 

as a 


None . 


CCL 


Correct procedure header CCL 
and resubmit. 


Correct procedure header CCL 
and resubmit. 


Reduce the number of CCL 

checklist options or 
have CCL reassembled and 
installed with an 
Increased value for 
Installation parameter 
IF.NFV. 

Correct the *8 range. CCL 


Insert 1 or M after CCL 

the a following the 
procedure name. 


BCASBBiO L 
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MESSAGE 


SICWIFlCAIiCE 


flCTlOti 


HOUTIIIE 


CCL327* EXPECTING VALUE AFTER PATTERN* ON 
HEADER 


CCL32«« 


HEADER PARAMETER DESCRIPTION TOO 
LARGE . 


CCL32S* 


MISC. AFTER HEADER PARAMETER 
DESCRIPTION 


CCL330' EXPECTING 
PATTERN 


OR J AFTER CHECKLIST 


eCL331> EXPECTING 
VALUE 


OR ) AFTER PATTERN 


CCL332* 


WRITE SET AS •SNCSET) ON PROC 
HEADER 


CCL333' 

CCL333- 

CCL333* 


DUPLICATE •K PATTERN IN 
DUPLICATE •N/«D PATTERN 
DUPLICATE *R PATTERN IN 


CHECKLIST 
IN CHECKLIST 
CHECKLIST 


CCL33«> MISSING OUOTE 
DESCRIPTION 


PROMPT/TITLE/ 


CCL335« DESCRIPTION MISSING 


BRACKET. 


The syntAx inmedfately fellewing the equal 
sign in the checklist is incorrect. The 
systeis expects an a 1 phanuner ie value, a 
or a special name as a value. 

A procedure header parameter description 
exceeds AO 6 / 12 'bit display code or so 
S'bit display cede characters. 

The only characters allowed to fellow the 
terminating quotation mark of a parameter 
description are equal sign, period, right 
parenthesis, slant, reverse slant, or comma. 

The pattern part of a checklist item can 
only be followed by another pattern 
preceded by a comma, a replacement value 
ppoceded by an equal sign, or a right 
parenthesis to indicate the end of the 
cheek list. 

The replacement value part of a checklist 
item can only be followed by another 
pattern preceded by a comma or a right 
parenthesis to indicate the end of a 
ehecklist. 

A set pattern in a checklist must be 
written as »S followed by an optional 
unsigned integer in the range 1«40 followed 
by up to 40 characters enclosed in 
parentheses. 

A single checklist may not contain mere 
than one >*R. >n/» 0. or «R. 


A prompt, title, or description string on 
the procedure header must begin and end 
with a quote and cannot extend onto another 
1 i ne,. 

The terminating right bracket tl) on a 
description string was net found. 


CCLSSe- PATTERN OR VALUE ON PROC HEADER 
.CT. 40 


CCL33T- EXPECTING . OR ) AFTER CHECKLIST 
PATTERN 


A Single checklist item may contain literal 
pAtterns and replacement values (values 
which stand for themselves]. These values 
may not exceed 40 characters in length. 

may net exceed 40 characters after 
evaluation. 

An SR checklist pattern can only be 
followed by another pattern preceded by a 
comma or a right parenthesis indicating 
the end of the checklist. 


Correct header and 
resubmit. 


Reduce the site of the 
description string. 


Correct procedure header 
and resubmit. 


Correct procedure header 
and resubmit. 


Correct procedure header 
and resubmit. 


Correct procedure header 
and resubmit. 


Correct procedure header 
and resubmit. 


Insert quotes. 


Start the string with a 
left bracket ((] and 
terminate it with a 
right bracket {]]. 

Correct procedure header 
and resubmit. 


Correct procedure 
header and resubmit. 


CCL 

CCL 

CCL 

CCL 

CCL 

CCL 

CCL 

CCL 

CCL 

CCL 

CCL 



MESSAGE 


SIGNIFICANCE 


ACTION 


ROUTINE 


ccLseo 

CCL3A1' 

CCL3S2> 

CCL3e3- 

CCL3S4> 

CCL3«5> 

CCLSaS 

CCL3«7- 

ccLses- 

CCL3SO- 

CCL382> 

CCL393> 

CCL394> 

CCL39S* 

CCL421 - 

CCL440- 

CCi.441 - 

CCL442* 

CCt.443* 

CCL48D« 

CCL4ai- 

CCL4<2° 

CCL483- 

CCL494* 

CCL49S- 


EXFECTINC TITLE OR , AFTER «M ON 
HEADER 


KETWORD MISSING ON MENU HEADER 


PROMPT ON PROC HEADER IS TOO 
LARGE 


MISSING SELECTION ON MENU HEADER 
TITLE ON PROC HEADER IS TOO LARGE 


EXPECTING 8 AFTER KEYWORD ON 
HEADER 


* EXPECTING COMMA AFTER HEADER 
TITLE 

BEGINNING OF HEADER CHECKLIST NOT 
FOUND 


EXPECTING INTEGER HEADER 
SELECTION OPTION 


EXPECTING , OR 1 AFTER CHECKLIST 
SELECTION 


EXPECTING , OR ) AFTER HEADER 
PROMPT 


EXPECTING PERIOD AFTER HEADER 
CHECKLIST 


TOO MANY HEADER SELECTIONS 
SPECIFIED 

HEADER SELECTION EXCEEDS 10 
CHARACTERS 

EXPECTING . OR I AFTER .DIRECTIVE 


EXPECTING INHIBIT CHARACTER • .IC 
DIRECTIVE 


EXPECTING CONCATENATION CHARACTER 
• . CC 


EXPECTING TERMINATOR ON DIRECTIVE 


EXPECTING ON/OFF .EXPAND 
DIRECTIVE 


USE NUMERIC MIN..MAX VALUES IN 
RANGE 


USE CONSECUTIVE PERIODS MIN..MAX 
IN RANGE 


MINIMUM EXCEEDS MAXIMUM IN RANGE 


»F DR sP RANGE 

LE. 7 


•A RANGE MUST 


USE •SNISETI 
ATTRIBUTES 


MUST BE .CE. 1 

.6E. 1 AND .LE 

•SN/M FOR SET 


BE 

OR 


AND 


. 40 


A titiR, If thore ts one, or « eemrae was 
net found inMROdi«tely following the sM on a 
menu procedure. 


You must specify a formal parameter Keyword 
after the procedure name in the procedure 
Header of a menu*genarating procedure. 

A prompt/description string on your 
procedure header is greater than 40 
6/l2*bit display code or 80 S-bit display 
cede characters. 

Your procedure header checklist has a null 
specification. 

A title string on a menu procedure header 
is greater than 40 S/I2*bit display cede or 
BO 6-bit display cede characters. 

An equal sign must fellow the parameter 
keyword on your procedure header. 


A character ether than a comma was found 
following the title on the procedure header. 

Either your procedure header does net 
contain a checklist or the checklist begins 
with a special character other than a left 
parenthesis. 

You specified a noninteger selection in 
your procedure header checklist. A 
selection must be a i* to lo-digit 
int eger. 

You specified a special character other 
than comma or right parenthesis after a 
menu selection on your procedure header. 


You spectfieo a special character ether 
than comma or right parenthesis after a 
prompt/description string on your procedure 
header. 


You specified either no period or a special 
character other than a period following a 
procedure header checklist. 

You specified more than so menu selections 
in your procedure header checklist. 

In your procedure header, a menu selection 
number contains more than to digits. 

A character other than a comma (.) or 
right parenthesis (I ) was specified 
between the directive name and its 
paramet ers. 

The .IC directive is missing a special 
character which would replace the current 
inhibition character. 

The .CC directive is missing a special 
eharaetar which would replace the current 
concatenation character. 

A CCL directive was net terminated by a 
period or right parenthesis. 


The only arguments allowed for .EXPAND 
AFo ON and OFF. The argument must be 
preceded by a comma er left parenthesis 
and followed by e period er right 
parenthesis. The argument may be 
emitt ed. 

A non-numeric minimum er maximum range was 
found within a checklist on the procedure 
header. 


Place e title surrounded CCL 
by quotes after the «M 
er else place a ceiRma 
after vM. 

Insert e peremeter CCL 

keyword. 

Reduce the size of the CCL 

prompt St ring. 

Specify a checklist with CCL 

integer selections. 

Reduce the site of the CCL 

title String. 

Insert an equal sign CCL 

after the parameter 
keyword. 

Place a comma after the CCL 

title. 

Specify a checklist CCL 

beginning with a left 
par ent hasis. 

Make all menu selections CCL 

int egers. 

Replace the special CCL 


character with e comma 
er terminate the 
checklist with e right 
parent hasis. 

Replace the specie! CCL 

character with e comma 
or terminate the 
checklist with a right 
parent hasis. 


Insert e period after CCL 

the check list. 

Reduce the number of CCL 

se1 actiens. 

Use lb er fewer digits CCL 

for your selection. 

Piece a comma (.] or CCL 

right parenthesis C( ) 
after the directive 
name. 

Specify e special CCL 

character as e 
replacement. 

Specify e special CCL 

character as e 
replacement. 

Terminate the directive CCL 

with e period er e right 
parenthesis. 

Correct the argument er CCL 

syntax end resubmit. 


Use e numeric minimum er CCL 
maximum range. 


A range was specified on the procedure 
header without 2 consecutive periods 
separating tha minimum and maximum. 

A checklist range on the procedure header 
has a minimum larger than the maximum. 


The •r and wp ehacklist patterns specify 
a fila nama. which cannot oxcoed 7 
characters. 


Use consecutive periods CCL 

to specify a rang#. 

Change either the CCL 

minimum er maximum and 
rasubmit tha proeedura. 

Correct range maximum to CCL 
7 or less. 


The range for the •A checklist pattern was 
sere or greater then 4b. 


Correct •A checklist 
range. 


CCL 


The •$ checklist pattern has two forms. 
The first is •sntSET) and the second is 
•Sn/m Cdascrtbed as •Sm..n/K in section 
4). The «s spedfieetion on the 
procedure header dees not conform to 
either. 


Correct the •$ checklist CCL 
pattern. 
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MgSSACE 


SICNIFICAWCE 


ACTION 


ROUTINE 


CCL4S6> USE MsA.O.B.AO.At for *$N/M TYRE 
SET 


CCL«A7>RAN6C MAXIMUM MUST 0E.6T.2ER0 
CFO FROM JOS jsn 
CFO FROM OFERATOR 

CHANNEL MALFUNCTION. AT AddrSSS. 

CHARBE COMMAND REOUlRED. 

CHARGE FILE BUSY. 

CHARGE NOT VALID. 


CHARGE NOT VALID AT THIS HOUR. 

CHARGE NUMBER EXFIREO. 

CHARGE s charosnumoor. PROJECT t 
proj«etnufBb«r . 

CHARGE RESTRICTED TO DEFAULT. 

CHECKPOINT nnnn COMPLETE. 

CHECKPOINT nnnn COMPLETED TO FMonamo. 

CHECKPOINT FILE ACCESS LEVEL ERROR. 


CHECKPOINT FILE ERROR. 

CHECKPOINT FILE ERROR. 

CHECKPOINT NOT FOUND. 

CHKPT UNABLE TO READ TAPE. 

CIO ERROR. 

CIO ERROR nn ON Vilpnan. 

CKP RBOUSST. 

CLASS ARGUMENT ERROR. 


Whpn th« aSn/m choeklist pattorn 
(dascribod as «Sia..n/k in saetien «) is 
usad. only A. D) B. AO, or AB may bo 
SUDStitutad for m. For axampla: 

S2..1O/A0 

A enacklist range on tha procadure naadar 
has a maximum of ataro. 

Tha CFO command was issued to tha job by 
tha job jsn. 

Tha CFO command was issued to tha job by 
tha console operator. 

A hardware malfunction occurred. 

Dayfila massage indicating that a CHARGE 
command must be executed before tha 
requested command can be executed. 

Dayfila massage indicating that the file 
Which tha system uses to validate charge 
numbers and project numbers is busy. 

Dayfila and output file message indicating 
one of the following: 

Tha charge or project number dees not 
exist. 

The project number is not available to a 
user with this user name. 

> Tha charge and project exist but are 
inactive. 

Dayfila message indicating that the 
specified project number cannot be used at 
this time of day. 

Dayfila and output file message indicating 
tha charge number expiration date has 
occurred. 

Message issued to the job dayfila any tme 
a CHARGE command is processed. The 
message is also issued when charge and 
project numbers are set automatically {at 
Job initiation 1 . 

You may net specify charge and project 
numbers ether than the default ones for 
this user. 

Indicates that checkpoint nnnn has 
completed. Issued if only one checkpoint 
file is present . 

Indicates that checkpoint nnnn has been 
completed to file filename. Issued if 
alternate CB checkpoint files are used. 

In a secure system, the checkpoint file 
access level is net the same as the job 
access level limit. This is to insure that 
the checkpoint file is secure enough to 
contain all local files. The access level 
of the checkpoint file is net changed to 
this level since this is net possible for 
magnetic tape files or direct access 
permanent file, and these are the usual 
file types used for checkpoint files. 

For RESTART, this message indicates that 
the structure of the file declared to be 
the checkpoint file does net correspond to 
that of a checkpoint file. 

During a checkpoint operation, mere than 
two checkpoint files were present or two 
checkpoint files of type CK were present. 

The specified checkpoint {nn parameter on 
RESTART command) could not be found on the 
f i le. 


Correct the •$ checklist 
patt ern. 


Change the maximum to a 
value preater than sere. 

None. 


None. 


Inform site analyst. 

Enter a valid CHARGE 
command and then reenter 
the original command. 

Reenter CHARGE command. 


Cheek correctness of 
charge and project 
number. use another 
charge and project 
number. 


Retry during the time 
the project number is 
valid. 

None . 


None . 


Specify the default 
Charge and project 
numbers. 

None. 


Insure that the access 
level of the checkpoint 
file is the same as the 
job access level upper 
1 init. 


Correct specification of 
checkpoint file. 


Correct specification of 
checkpoint file. 


Verify that checkpoint 
is on file. 


Indicates a tape file had an unrecovered 
parity error when CHKFT tried to write it 
to the checkpoint file. 

updating of resource file returned error 
status ether than end*ef>device. 


A CIO error with octal error cede nn 
occurred while RESEX was trying to open 
tape file filenam. 

A checkpoint has been initiated. 

One of your arguments is net correct. 


N 


one . 


Rerun the job. If the 
problem reoccurs, inform 
a site analyst, write 
a FSR and include 
support material so that 
GDC can duplicate the 
problem. 

Use a different tape. 


None. 

Cheek command 
description, then retry. 


CCL 

CCL 

1RI 

1R1 

1MT 

VALEX 

VALEX 

VALEX 

VALEX 

VALEX 

VALEX 

VALEX 

CHKFT 

CHKFT 

CHKFT 

RESTART 

CHKFT 

RESTART 

CHKFT 

RESEX 

RESEX 

CHKFT 

CLASS 
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WESSACg 

CLASS COMPLETE. 

CM SLOCK OUT OF RAMCE. 

CM OR EC REQUEST EXCEEDS MAXIMUM. 

CM OUT OF RANGE. 

CM PARITY ERROR. 

CM RANGE EXIT MODE NOT OESELECTABLE . 

CMC PARITY ERROR. 

COMMAND ARGUMENT ERROR. 

COMMAND ERROR. 

COMMAND PILE ERROR. 

COMMAND LIMIT. 

COMMAND NOT ALLOWED IN PROLOCUE/EPIL06UE. 

COMMAND NOT PROCESSED DUE TO OVERLAP. 
COMMAND NOT UNIQUE. 

COMMAND TOO LONG. 

COMMENT FROM JOB jsn 
COMMENT FROM OPERATOR 
CONFLICTING PARAMETERS. 

CONFLICTING RESOURCE TYPES. 

CONNECT REJECT, AT AddrASs. 

CONNECTION REJECTED. 

COPY COMPLETE. 

COPY FL ABOVE USER LIMIT. 

COPY INDETERMINATE. 

COPY NOT ALLOWED OF RESERVED FILE NAME 
f 1 lAn«ni«. 

COPYING typ« / naiii* 


SIGNIFICANCE 

ACTION 

ROUTINE 

An {nferiSAtfva nossAott indicating that your 
attampt to change a job's sorvice class was 
sueeassfu 1 . 

None. 

CLASS 

trangFar from awtandad mamory 
spacifiad a CM address outside the job 
field length. 

Analyse the job 
output end dumps to 
determine the cause 
of the error. 

1 AJ 

Field length of more than 3777QQ octal 
(CM) or mere than 77777 octal (EM) was 
specified in an RFL command. 

Retry with lower 
values. 

CONTROL 

The program referenced an address outside 
the job CM field length. 

Analyse the job 
output end dumps to 
determine the cause 
of the error. 

1 AJ 

Double data parity error (two data bits 
failed) between central memory control 
(CMC) and CM as detected by the 

Singic'error correction double*error 
***TACtion (SECDEO) network, or a single 
parity error when operating in default mode 
(SECOED network disabled). 

Inform customer engineer. 

1 AJ 

You attempted to deselect system checking 
for CM out of range errors. This cannot be 
dene on a model 176. 

Determine if the program 
can run with CM range 
error cheeking. If it 
cannot, the program must 
be changed. 

CPM 

The CPU sent the central momery control 
(CMC) data or an address having incorrect 
parity. 

Inform customer engineer. 

lAJ 

An incorrect parameter was entered for 
the command. 

Correct parameter end 
retry. 

lEOIT 

An incorrect parameter was specified on the 
command. 

Correct command and 
retry. 

EDIT 

L XSTLB 

An unrecovered disk error occurred while 
the system was processing the command. 

Rerun the job. 

LFM 

The system has processed the makimum number 
of commands allowed in one of your jobs 
(refer to the LIMITS command). 

If you must rerun the 
job, restructure it such 
that it requires fewer 
commands. 

1AJ 

A CHARGE command was placed in a system 
prologue or in a project prologue or 
epilegue. 

Ramove the CHARGE 
command from the 

System prologue or 
the project prologue 
or epilogue. 

VALEX 

You have specified overlapping line 
numbers on the adit command. 

Correct line numbers 
and ratry. 

lEOXT 

The characters anterad do net uniquely 
specify a command. 

Ensura accuracy of 
entry. Enter e 
sufficient number of 
ehereeters to specify e 
unique commend. 

lAFEX 

YOU entered a command string longer 
than SO characters. 

Roentor using e shorter 
version of the command. 

1 AFEX 

A COMMENT command was issued to the job by 
the job jsn. 

None. 

1RI 

A COMMENT command was issued to the job by 
the console operator. 

None. 

1R1 

You queued a file and specified an input 
disposition more than once. 

Reenter with correct 
pereraeters• 

SUBMIT 

PE. HO, and 6E resources cannot be 

Speeifiod concurrently with an NT resource 
in the same job. 

Correct the RESOURC 
command. 

RESEX 

The system was unable to connect a 
peripheral device. 

Inform site analyst. 

1MT 

The requested application is already 
sarvieing the maximum number of terminels. 

Request a differant 
application or log off 
and t ry lat ar. 

NETVAL 

Copy termination condition was Satisfied 
bafora EDI was aneountarad. 

None. 

COPYB 

COPYC 

Field length for L or F tape copy exceeds 
your currant maximum. 

Use smallar block sisa 
on L end F tapes or 
increase eeximum FL. 

COPYB 

Your copying operation with S. L, or F tape 
is unpredictable. Only the COPY command 
supports those formats. 

Ratry copy using tha 

COPY command. 

COPYB 

An attampt was made to make e local copy 
of e file with the soma name as a RECLAIM 
scratch file, dump file. INPUT, or OUTPUT. 

Retry using a 
different local file 
name. 

RECLAIM 

The record with the type end name on the 
eld file was copied to the new file. 

None. 

COPYL 
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MESSAGE 


SICWiriCAHCE 


ACTlOli 


ROUTINE 


COPVL COMPLETE. 

COPVL DIO NOT PINO typ« / R«ra« 

CORRECTION lOENTS LISTED IN ORDER OP 
INSERTION. 


CPM - 

ACCESS LEVEL NOT VALII 

CPM > 

ARGUMENT 

ERROR. 

CPM - 

INCORRECT 

PACK NAME. 

CPM - 

INCORRECT 

PAGE VALUE. 

CPM • 

INCORRECT 

REQUEST. 

CPM ‘ 

INCORRECT 

SHELL PILE. 


CPM • LltRARY NOT POUND > library. 

CPM > MASS STORAGE ERROR. 


CPM > MISSING SHELL LOAD OPTION. 

CPM ' SYSTEM ERROR. 


All raeords on tha eld file have baan 
preeassad. 

Tha raeerd with typa and nania on tha 
raplacamant file was net found on tha eld 
file. Since tha A ep'tien was net salactad, 
tha record is ionerad. 

Infernativa massage indicting an expanded 
1 i St i ng . 


You attempted to change the job access 
level to a value net valid for the job. 


An incorrect argument was specified. 


An incorrect pack name was specified. 


There was an error in your job page site 
infemat ion. 

A job has an incorrect CPM function or 
subfunetien cede, or extended reprieve is 
set (for EREXIT). 

You entered a SHELL command with one of the 
following errors: 

-* The specified shell program was not 
found on mass storage. 

You specified the local lead option 
for a file that was net found in the 
local file name table (PNTl. 


The system could not find the 
Specified library. 


One of the following occurred: 

* A irrecoverable error occurred when 
your job attempted to access a mass 
Storage device. 

Your job was aborted after being 
relied out due to a recoverable mass 
storage device error. 

You attempted to set a shell control 
without specifying a lead option. 


Per function 42 (Special Charge) or 10S 
(Set Job Characteristies)< CPM was unable 
to road the input file. 


None. 

None. 


None. 


Retry with a valid level. 


Retry the command using 
valid arguments. 

Ensure that a valid pack 
name is used. 

Retry with correct 
values. 

Specify auto recall on 
monitor request call to 
CPM. 

Correct the SHELL 
command or create the 
proper shell program 
file. 


Ensure that the library 
name is correct on the 
eenmand or macro. 

Inform site analyst. 


Specify a 
the SHELL 
macro and 


load option in 
command or 
try again. 


Write a PSR and include 
support materials to 
allow CDC to duplicate 
the problem. 


COPYL 

COPYL 

ITEMIZE 

CPM 

CPM 

CPM 

CPM 

CPM 

CPM 

CPM 

CPM 

CPM 

CPM 


CPM 


USER ACCESS NOT VALID. 


One of the following occurred: 


Ensure that the L 


CPM 



MESSAGE 


SISWtFlCAMCE 


ACTIOIt 


ROUTINE 


DATA TRANSFER ERROR. 


DATABASE CORRUPTED. 

DATABASE NOT FOUND’DEPININC NEW ONE. 

OAYFILE • INCORRECT JOB TERMINATION OPTION. 
OAYFILE - INPUT FILE CANNOT BE EXECUTE ONLY. 

OAYFILE - INTERACTIVE INPUT FILE NOT ALLOWED. 

OAYFILE • JOB FIELD DISALLOWED ON USER 
DAYFILE. 

OAYFILE ' LOCAL OAYFILE PROCESSED. 

OAYFILE - PACE SIZE FORMAT. 

OAYFILE - PRINT DENSITY. 

OAYFILE • PRINT DENSITY FORMAT. 

DC REQUIRED IF JSN/UJN NOT SPECIFIED. 
•DEBUe>CARBAGE IN ZZ2ZZOS FILE. 

DEBUC-ILLEGAL PARAMETER'p. 

0EBU6-0NLY ONE PARAMETER ALLOWED. 
•OEBUC'ZZZZZDS FILE NOT FOUND. 

DECK LIST. 

DEFAULT CHARGE NOT VALID. 


DEFAULT CHARGE NULL. 
DEFAULT FAMILY USED. 

• DEL* 


DEMAND EXCEEDED. 

DEMAND FILE ERROR. 


prpop oceurrsd in a ra«d oparation 
during a fila transfar. 


RECLAIM aneauntarod a preblam with tha 
databasa; usually indieatas that tha 
database is empty er has bean evarwrittan 
with semathing other than a database. 

reclaim did net find tha specified database 
in your catalog and is attempting to define 
a new one. 

An incorrect value was specified for the 
JT option. 

You specified an axeeute-enly file in the 
Is infile parameter of the OAYFILE command. 
The input file cannot be execute-only. 

Dayfile date cannot be entered directly 
from the keyboard. 


Options spocified are net allowed for your 
job's dayfile processing. 

DAYFILE has successfully completed 
processing a local file as input. 

The page site option is nonnumeric. 


The print density option is not 3.4,6. or 8. 


The print density option is nonnumeric. 
Print density must be 3.4,6. or 8. 

If the JSN or the UJN parameters are 
emitted, tha DC parameter must be entered. 

File ZZZZZOS contains information other 
than the suspended job of the current 
session. Retrieval of debug information 
from session is impossible. 

You specified an incorrect parameter on 
the OEBUC command. Tha three parameters 
allowed ere ON. OFF. er RESUME. 

You entered mere than one parameter on the 
DEBUG eeiMnand. 

You did net suspend the debug session 
during the currant terminal session. Refer 
to the SUSPEND commend (CYBER Interactive 
Debug Version 1 Reference Manual]. 

Informative message indicating an 
expanded listing. 


accurate. Enter e 
CATLIST command to 
sea if tha permits 
are accurate. 

Inform site analyst. If PFM 
many of these errors 
occur, the site analyst 
should perform a full 
PFDUMP. total INITIALIZE, 
and full PFLOAO on the 


dev ice. 


Cheek to ensure that 
your database is in 
correct RECLAIM format 
and that it is net empty. 

RECLAIM 

None . 

RECLAIM 

Correct option and ratry. 

OAYFILE 

Spacify an input file 
that is net axocute-only. 

OAYFILE 

Spacify dayfile input 
from ether than the 
terminal (TT device). 

OAYFILE 

Retry with a correct 

OPsop parameter. 

DAYFILE 

None . 

DAYFILE 

Retry with a valid 
option. 

OAYFILE 

Ratry with a valid 
option. 

OAYFILE 

Retry with e valid 
option. 

OAYFILE 

Add the DC parameter and 
retry. 

06ET 

DROP 

Return file ZZZZZOS and 
restart debug session. 

DEBUG 

Reenter DEBUG command 
with correct paramatar. 

DEBUG 

Roantar DEBUG command 
with correct parameter. 

OEBUC 

Restart debug session. 

OEBUC 


None. 


ITEMIZE 


.nd output »( 1 « nassogo indicottng Use onothor enorgo and VALEK 

ena of tha follexng: projact numbar . 

The default charge er project number 
associated with the current user name 
dees net exist. 

• The default charge or project numbar 

associated with the current user name is 
net available to that user name. 

- The default eharga and prejaet numbars 
asseeiatad with tha currant usar nama 
exist but are inactive. 


No default charge and project numbers are 
defined for this user. 

Spacify valid charge 
and project numbers. 

VALEX 

You entered e PAMILY ceiMiand with no 
parameter. The default family was used. 

None. 

CONTROL 

The system has deleted the last line of 
input. This occurred when the terminal 
operator entered the cancel character (CN) 
followed by the end of line/end of block 
torninetor. 

None. 

CCP 

You ettompted to assign more units then 
were scheduled on the RESOURC commend. 

Increase appropriate 
parameter value on 

RESOURC conmand. 

RESEX 

Resource execution error'was eneountared. 

This error occurred because the demend file 
(RSXOid) entry dees net match tha job 
identifieat ion. 

Rerun the job. If the 
problem reoccurs, inform 
• site analyst, write 

A PSR and include 
support material so that 
COC can duplieata tha 
preblam. 

RESEX 
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MESSflCe 


SICWIFICAWCE 


ACT low 


ROUTINE 


DEMAND VALIDATION ERROR. 

DETACH LIMIT EXCEEDED. 

DEVICE ERROR ON FILE AT address. 

DEVICE XNACCESSI8LE • DETACH FAILED. 
DEVICE INACCESSIBLE • LOGIN FAILED. 

DEVICE INACCESSIBLE • RECOVERY FAILED. 
DEVICE UNAVAILABLE. 


DIRECT ACCESS DEVICE ERROR. 


DIRECT ACCESS FILE ERROR. 


DIRECTIVE ERRORS. 

n DIRECTIVE ERRORS. 

DISK FULL. 

DMs TOO SHORT. 

OROF COMFLETE. 

DROFFED BY USER JOB jsn. 

OSF - ALTERNATE FAMILY NOT ALLOWED. 

DSF • CANNOT ROUTE JOB INFUT FILE. 

OSF • COMFLETE BIT ALREADY SET. 

DSF - DEFERRED ROUTING NOT ALLOWED. 

DSF • DEVICE FULL. 

DSF • FILE NAME ERROR. 

DSF ■ FILE NOT ON MASS STORAGE. 

OSF • FILE ON REMOVABLE DEVICE. 

OSF > FORMS CODE NOT ALFHANUMERIC. 

OSF • X/0 SEOUBNCe ERROR. 


Tho spRcffiAd numbar of units axcaads your 
validation limits. 


YOU hava toe many datachad jobs or ara net 
authorizad to dataeh jobs. 


An irracevarabla arror eeeurrad on tha mass 
storaga daviea containing t»ia file filanama. 

Your job could net be datachad due to a 
mass storage daviea arror. 

Login failed because of a mass storage daviea 
error. 

Your job could net be recovered due to a 
mass storaga error. 

Message resulted from one of tha following: 

A pacHname was specified for a pack tnat 
is net currently mounted. 

• For a OIS job, no SUt or USER command 
has bean entered. 

No permanent file daviea could be found 
for your user name. 

On a secure system, no permanent file 
device with the proper access level 
could be found for your user name. 

Message resulted from one of the following: 

An incorrect device type was specified. 

- The device on which the local file 

resides may not contain direct access 
files. 

The System sector for the file contains 
incorrect data or cannot be read. 


A LIBEOIT directive has incorrect syntax. 

The system could net interpret n directives. 


Job was terminated without exit processing. 
System file DM* cannot aeeemmedate the dump. 
Informative only. 

The job was dropped by the job jsn. 

You attempted to route a file or a job to 
a different family, and you are not 
validated te do this. 


An attempt was made te route the job input 
file. 


The complete bit was net cleared before OSF 
was celled. 


A file cannot bo deferred routed if date 
deeleretien or imp 1icit/exp 1ie1 1 remote 
text is specified. 


TNafo is no space on the device for current 
use. 


An attempt was made te create a Vila with 
an incorrect file name. 

An attempt was made to route a flla net on 
mass storaga. 

A file on a removable device cannot be 
r out ed. 


The forms code specification (FCsfe 
paremoter) must consist of two 
alphanumeric characters. 

A request was OMde on a busy ffla. 


Oacraase appropriate 
peremeter value on 
RE50URC commend. 

If you ere authorised te 
detach jobs, enter 
ENOUIRE.JSN to identify 
existing detached jobs 
end OROF,jsn to drop 
selected jobs. 

Inform customer engineer. 


Inform site analyst. 


Inform site analyst. 


Inform site analyst. 


If e peek name was 
specified, try again 
with the WB or NA 
peremeter te request 
that the pack be 
mounted. For ether 
errors, inform site 
operet or. 


Specify eorroet device 
type or return the 
local file end retry. 


Inform site analyst. If 
many of these errors 
occur, the site analyst 
should perform e full 
PFOUMF, total INITIALIZE, 
end full FFLOAD on the 
device. 

Examine the LIBEOIT 
output to determine 
cause of error. 

Correct errors as listed 
in LIBEOIT output end 
rerun job. 

Resubmit job. 

inform site analyst. 

None. 

None. 

If you need t e be 
able te route te e 
different family, 
centeet site 
personnel. 

Copy the job input 
file to e local file 
end route it. 

Clear the complete 
bit before celling 
DSF. 

Correct end retry. 


Retry ROUTE commend 
or macro at e later 
t ime. 

Specify valid file name. 


Copy file to mess 
storage before routing. 

Copy file to 
nonromoveble devico 
bofore routing. 

Spocify elphenumerie 
forms code. 


wait unti 1 file is net 
busy. 


RESEX 

ZAFEX 

IMS 

lAFEX 

lAFEX 

lAFEX 

FFM 


FFM 


FFM 


LIBEOIT 

LIBEOIT 

1AJ 

CFMEM 

DROP 

OROF 

DSF 


OSF 

OSF 

OSF 

OSF 

DSP 

OSF 

OSF 

OSF 

DSF 


B- ft 
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MESSaCE 


SICWIFICAWCE 


ACTION 


ROUTINE 


• IMMEDIATE ROUTING • NO FILE. 

DSF - INCORRECT DATA DECLARATION. 

OSF - INCORRECT OISFOSITION CODE. 

DSP - INCORRECT EXTERNAL CHARACTERISTICS. 
OSP • INCORRECT FILE MODE. 

OSP • INCORRECT FILE TYPE. 

DSP - INCORRECT INTERNAL CHARACTERISTICS. 

OSP • INCORRECT LIO. 

DSP > INCORRECT ORIGIN TYPE. 

DSP * INCORRECT REOUEST. 

OSP • INCORRECT SERVICE CLASS. 


OSP - INCORRECT TIO. 


DSP > INCORRECT USER COMMAND. 

OSP • JSN ALREADY IN SYSTEM. 

DSP > MASS STORAGE ERROR. 

OSP - OFT FULL. 

DSP • QUEUED FILE READ ERROR. 

OSP > THIS ROUTING NOT ALLOWED. 

DSP • TOO MANY DEFERRED BATCH JOBS. 

DSP ‘ USER ACCESS NOT VALID. 

DSP - USER SECURITY COUNT EXHAUSTED. 

DUMP FILE CONTAINS 63 DUMPS. FILE IS FULL. 


TH« sp«eifi«d file For tH« iminodt«t« 
routing could net be found. 


The specified date deeleretien is not 
recegnisod. 

The specified disposition cede is not 
reeegnized. 


You specified en undefined externel 
cherecteriStic cede. 


You ettempted to route en execute>en1y file. 


You entered e ROUTE eennend or neero that 
attempts to route a primary file or a 
direct access file. These files cannot 
be routed. 

You specified an undefined internal 
characteriStics code. 


You specified an incorrect logicel 
identifier (LIO) for e remote meinfreme on 
the ROUTE command. 


The system cennot queue the file for input 
with the specified origin type. 

Message resulted from one of the following: 

’ Perameter block is not within fiald 
length. 

Request was not made with auto racell. 

The two'Cheracter service class is not 
valid for the user or the origin type of 
thefile. 


Message resulted from one of the following: 


user name and family name parameters were 
not in CM field length. 

Terminal identifier (TIOJ is greater 
then er equal to lOLM for baton jobs. 

The family nama or user name is not valid. 


for an operation on an input file, either 
a USER command was net included or the 
user name er password on the USER commend 
is net vei id. 


You attempted to specify a forced JSN, 
but the specified JSN was already in use. 

^ "••ss storage error was encountered on the 
file. 


The system cannot process your file because 
it is already processing its maximum number 
of queued files. 

The system encountered en equipment 
malfunction and, consequently. cannot 
process your deferred routed file. 

You attempted to chenge the queue 
disposition of e deferred routed file. 


You attompteo to submit more deferred batch 
jabs than allowed by your validation limit. 


Cellar is not veil dot ad to specify one of 
the fellewing: 


DLID 

SLID 

Date declaration 


You attempted to route en input file to e 
user name which has exhausted Its 
security count. 

In response to a DUMP or COMPACT 
operation, RECLAIM has detarrainad that 
the dump file already contains the 
maximum allowable number of dumps; this 
directive is ignored. 


Ensure that file to be 
routed is available to 
the job for processing 

Correct end retry. 


Correct disposition 
cede end retry. 

Correct and retry. 


Ensure that the file to 
be routed is not en 
execute'only file. 

Copy the file to e 
toraperary local file 
and retry the ROUTE 
for the local file. 

Correct internal 
characteristics code 
end retry. 

Ensure that your LID 
Specification is 
correct. If the 
problem persists, 
inform site analyst. 

Specify valid origin 
typo. 

Change parameter block 
addresses er specify 
out o recall. 


Correct end retry. 

If you ere unable to 
specify a service 
class that you ought 
to be able to use. 
contact site 
personnel. 

Verify that TID 
parameters ere valid. 


Verify that a USER 
command is present and 
that the user name end 
password ere correct. 

Botry, specifying e 
different JSN. 

Raereete the file end 
retry. 

Wait and retry. 


Recreate the output file. 


Rescind prior routing by 
using tho SC disposition 
eodo with tho ROUTE 
commend or macro. Routo 
tho filo again with tho 
dasirod final 
disposition cede. 

Wait for jobs to 
cemplote er request a 
larger velidetien limit 
from site personnel. 

Contact site 
personnel if you nood 
to bo eblo to do 
this. 


Contact site support 
parsennoi to gat your 
security count roset. 

Compress tho current 
dump file using the 
COMPACT directive er use 
« new tape. 


OSP 

OSP 

DSP 

OSP 

DSP 

OSP 

OSP 

OSP 

DSP 

DSP 

OSP 

OSP 

DSP 

OSP 

OSP 

OSP 

OSP 

OSP 

OSP 

DSP 

DSP 

RECLAIM 


SOASSSSO L 
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WESSA6E 


SIGWIFICAtiCE 


ACTIOW 


AOUTIHE 


OUMF FILE MALFUNCTION'EOI ENCOUNTERED. 

DUMP FILE MALFUNCTION-FILE NAME MISMATCH. 

DUMP FILE MALFUNCTION-POSITION LOST. 

DUMP FILE MALFUNCTION-UNRECOCNI2ABLE PFC. 

DUMP FILE MUST BE IN WRITE MODE 

DUMP FILE NOT FOUND 

DUMP NOT ALLOWED OF RESERVED FILE NAME 

emd DUPLICATE CHARACTER 

DUPLICATE FILE NAME. 

DUPLICATE FILE NAME. 

DUPLICATE UJN - MUST SPECIFY JSN. 

DUPLICATE UJN - MUST SPECIFY JSN. 

DUPLICATED LINES. 

EC NOT VALIDATED. 


An EO! was ancountarad bafara tha spae{fiad 
dunp Vila or racerd was found; tna tapa has 
probably boon ovarwritten. 

Tha spaeifiad fila naraa doas not natch tha 
fila nama found at tha spaciffad position 
on tha dump taps; tha tapa has probably 
baan evarwrittan. 

reclaim systam orror . 

"fho PFC for tha dumpad fila is incorract ; 
aithar tha tapa is bad or has baan 
ovarwrittan. 

A DUMP or COMPACT was attaaptad using a 
"*ass storaga dump fila which was attached 
in soma moda otnar than WRITE noda. 

A LOAD or COPY was attaaptad and tha mass 
storage dump file indicated by tha data 
base could not bo found. The file nay have 
baan purged or may never have baan made 
parmanant. 


An attempt was made to dump a local fila 
with tha same nama as a RECLAIM scratch 
fila. dump fila. INPUT, or OUTPUT. 

The value you specified in tha terminal 
definition command end conflicts with 
another terminal definition. 

The fila specified already exists in tha 
system. 

A duplicate file name was encountered on 
a single directive. 

Two of your jobs have the same UJN. 


Mora than one job exists with tha 
specified UJN. 


Duplicate lines, which would have bean 
printed during a dump operation, ware 
suppressed. 

The number of extended memory blocNs 
spaeifiad on the Job command either exceeds 
that for which you are authorized or 
axeaads the machine size available to user 
jobs. 


Cheek the contents of 
the dump file tapa. 


Check the contents of 
the dump tapa. 


Inform site analyst. 

Check the contents of 
the tape. 


Attach tha dump file in 
WRITE mode and retry. 


Cheek your options. If 
they are correct, you 
may have to load your 
files from an alternate 
source. Check with your 
site analyst. 

Retry using a 
different local fila 
name. 

Try another value. 


Use different name in 
request. 

Correct directive. 


Use tha ENOUIRE command 
to determine the 
appropriate JSN to use. 

Specify a JSN instead 
of ior in additon to) 
the UJN. 

None. 


Check your validation 
with the LIMITS command. 


RECLAIM 

RECLAIM 

RECLAIM 

RECLAIM 

RECLAIM 

RECLAIM 

RECLAIM 

CCP 

LFM 

lEDIT 

P6ET 

DROP 

CPMEM 

CPM 


EDITING COMPLETE. 


L i br a r 


)d i t 1 nn i 






MESSAGE 


SICNIFICAMCE 


ACTION 


NOUTINE 


ENOUIRY COMPLETE. 

ENTER CO TO CONTINUE CURRENT JOB. 

RELIST TO LIST RECOVERABLE JOBS. 

OR DESIRED JSN: 

ENTER TEXT MOOE. 

ENTERING RECOVERY MODE ... WAIT 

ENTERING 7000 MODE .. WAIT 
ENTRY POINT NOT POUND. 

ENTRY POINT TABLE OVERFLOW. 

EOF ENCOUNTERED. 

EOI CHANCED BY RECOVERY. 


EOt ENCOUNTERED. 


EPILOGUE AND SHELL 


CONFLICT . 


EOest. ONOn . laessAge . 


EOUIPMENT NOT AVAILABLE. 


M«ss«g« isswsd whon ENQUIRE eomniand 
precsssfng is completod. 

You h«v« pseovorable jobs and tha systam 
avaits your input. 


Infermativa massaga indicating you ara in 
taxt mode. 

SCOPE 2 is antaring racovary meda. Thara 
is a dalay until the racovary cycle 
completes. 

The user is entering 7000 mode. 

The specified entry point could net be 
found. 

The number of entry points par progrann unit 
has exceeded the table space allowed. 

End'Of-file was encountered before copy 
termination condition was satisfied. 

The file was truncated during deadstart 
recovery. 


End-of‘informetion was encountered on the 
input file. 


A shell program with the ne-abort option 
set was active at the tine you attempted 
to specify charge and project numbers 
which had an epilogue defined. 

A form of PFM error message {issued to the 
system dayfile. error leg, and sometimes 
the user dayfile) identifying the mass 
storage equipment on which the error 
occurred. 

est EST ordinal of device 

dn Device number 

message PFM error message 

The requested equipment is either in use 
or dees net exist, or no requested 
equipment with the proper access level 
can be found. 


None. 


Enter appropriate 
r esponse. 


None. 


Wait for the user prompt. 


Wait for prompt. 

Verify that the entry 
peint is valid. 

Contact CYBER Software 
Support. 

None . 


Use the CHANGE command or 
macro with CE parameter 
to allow access to the 
file. Make the file 
local and list it to 
determine hew much of 
the file was lest. 

If the message was net 
expected, cheek if the 
copy was performed as 
desired. The source 
file may net have been 
positioned correctly 
before the copy. 

Specify charge and 
project numbers which 
do not have an 
epilogue defined. 

Refer to the 
significance and action 
of the message as given 
in this list of error 
messoges■ 


Ensure accuracy of macro 
or command or ratry at a 
latar tima. 


For 1600 cpi or 6250 cpi donsitias. the Clean tape drive. 

block could net bo rewritten properly Have the tape cieaited and 


ENQUIRE 

RECOVER 

lAFEX 

NELL07 

HELL07 

1AJ 

LIBRARY 

COPYB 

PFM 

COFYB 

COPYC 


VALEX 


FFM 


LFM 

RESEX 


ERASE LIMIT, filaname AT addrass. 


1MT 



MESSAGE 


SICMiriCANCE 


ACTIOS 


EOUTIWE 


ERROR IN ARGUMENTS. 

ERROR IN ARGUMENTS. 


ERROR IN ARGUMENTS. 

ERROR IN ARGUMENTS. 

ERROR IN ATTACHING USER DATABASE. 

ERROR IN BACKUR REOUIREMENT. 

ERROR IN CHVAL ARGUMENTS. 

ERROR IN CONTROL ARGUMENTS. 

ERROR IN DATE. 

ERROR IN DEFAULT CHARGE. 


You spRcffiAd an XD or XT paramatur In a 
DEFINE or SAVE command without 
spacifying a PW paramator. 

Tha systom did not raeognlsa ena or mera 
paramat ar$. 


Ona or nora of tha following command arrers 
wara dataetad: 

Mora than ona data was antarad. 

' No options wara salactad. 

• Tha paramatar was incerraet or could net 
da raeognisad. 

> Tha TM option was salactad but no data 
was spaeifiad. 

* Beth tha daviea number paramatar and tha 
pack nama or auxiliary daviea paramatar 
wara salactad; auxiliary davicas do not 
hava daviea numbers. 

Beth tha NA and WB pararaatars wara 
spaeifiad; salaet ona or tha other. 

RESTART dataetad incerraet arguraants on the 
command call. 

A paramatar spaeifiad on tha Job. USER, 
or CHARGE command was net correct. 

RECLAIM system error. 


The option specified on tha BR paramatar on 
tha DEFINE. CHANCE, or SAVE command is 
incerr act. 


Compare tha pararaatars 
specified with tha 
command description. 

Correct coamand. and 
retry. 


Correct tha coamiand. 


Correct tha paramatar 
in error and retry. 

Check the dayfila for a 
more specific error 
massage. If there is no 
massage in tha dayfila. 
inform tha site analyst. 

Cheek the BR parameter 
description and correct 
the command. 


An incorrect keyword was specified on tha 
eonmand or too many characters wara 
specified for tha UC parameter. 

Either tha number of arguments was 
incerraet. an incorrect argument was 
spaeifiad. or a numeric parameter was 
nonnumarie. 

Tha format of tha date (ad. md. or ed) 
parameter in a FURCALL request was 
incorr act. 

A default charge number is defined for 
this user, but no default project number 
is defined. 


Correct and retry. 


Cheek the description of 
the command. 


Cheek the format of tha 
FURGALL command in 
sect ion to. 

Specify valid charge 
and project numbers. 


MFILES 

BLANK 

1TCM12C 

FURGALL 


RESTART 

VALEX 

RECLAIM 

FFILES 

MOOVAL 

CONTROL 

FURGALL 

VALEX 


ERROR IN DEVICE NUMBER. 


Tha file residency as specified by the 


Correct the device 


FURGALL 





MESSAGE 


SlGWtriCAMCE 


ERROR IN MODE. 

ERROR IN RASSWOft ARGUMENTS. 

ERROR IN PERMIT DATA. 


ERROR IN PRErSRRED RESIDENCE. 

ERROR IN RESIDENCE. 

ERROR IN ROUTE FUNCTION. LFN:fn«nanift. 

ERROR IN SECHDR PARAMETERS. 

ERROR IN SUBSYSTEM. 

ERROR IN SYSTEM TEXT. 

ERROR IN TIME. 

ERROR IN TRMDEF ARGUMENT. 

ERROR IN UFROC ARGUMENTS. 

ERROR IN 5TH COFYL PARAMETER 

ERROR LIMIT. Intogttr ADDITIONAL ERRORS 
POUND . 

ERROR LIMIT EXCEEDED. 


Th« option spociPioo 
incorroct. 


on the M pAronetor is 


An incorroct poronotor or on incorroct 
nunbor of p«r«reetors wore ontorod on the 
PASSWOR commond or in rospense to on 
intoroetivo prompt from tho PASSWOR 
commond. 


Chock tho M poromotor 
description ond correct 
tho commond. 

Correct tho PASSWOR 
commond ond resubmit. 


When tho specified file wos looded fro 
tope, on error wos encountered in the 
permit entries. 


The option specified on the PR poromotor on 
the SAVE. DEFINE or CHANGE Commond is incerr 

The R>r poromotor you specified 
eontoins on incorrect device typo. 

Informotive messogo issued to the system 
*l*yfii* indicoting that on error occurred 
while routing filename. 

You specified on unknown poromotor on o 
SECHDR commond. 

The option specified on the SS poromotor on 
the CHANCE or SAVE commond is incorrect. 

The system text referenced by the KRONREP 
commond did not contoin symbol definitions. 


The formot of the time poromotor 
PURCALL request wos incorrect. 


One or more poremeters specified in the 
TRMOEP commend wore in error. 


Doyfile mossoge indicoting that incorrect 
commond orgumonts wore entered. 

Petol error; only A. R. e. ond T ore 
rocegnisod porometors. 

More then 20 errors wore found during 
cenvorsi on. 


Enter the CHANGE commend 
macro with CE poromotor 
to ollew oeeoss to the 
fi1e. Do o CATLIST to 
see if the permits ore 
occurote. 

Check the PR poremeter 
actdescription ond correct 
the commend. 

Correct tho Rsr 
poromotor. 

Exoffiino the job's 
doyfile for o more 
specific error mossoge. 

Reenter the commond with 
the correct porometers. 

Check the SS poromotor 
description end correct 
the commend. 

Ensure thot the system 
text specified by the C 
or S poremeter eontoins 
symbol dofinitions- 

Chock the formot of the 
PURCALL commend in 
section 10 . 

Ensure thot the 
porometers ore in 
correct formot ond 
new values ore valid. 

Specify the correct 
arguments ond rerun. 

Correct processing 
option. 

Verify deck ond rotry. 


integor 


Errors in excess of 20 


Number of parity ond bloek>toe*large errors 
•xceod the error limit. 


If doyfile shows block* 
toe*large errors hevo 
occurred ond tone i« s 


ROUTINE 

PFILES 

MOOVAL 

erPPM 

PPILES 

PPILES 

DSP 

SECHDR 

PPILES 

KRONREP 

PURCALL 

TRMDEF 

MODVAL 

COPYL 

PCOPV 

COPYB 



MgSSACE 


SICWlFICEMCg 


ACTION 


ROUTINE 


EXPECTING ? OR TERMINATOR AFTER 
SELECTION 

expecting ? OR TERMINATOR AFTER NAME ON 
CALL 

EXPECTING SELECTION AFTER COMMA ON CALL 

EXPECTING ? \ SEPARATOR ON RESPONSE 

EXPECTING . / \ SEPARATOR ON RESPONSE 

EXTENDED MEMORY BLOCK OUT OF RANGE. 

EXTENDED MEMORY FLAG REGISTER PARITY. 
EXTENDED MEMORY MINIMUM CM NOT VALIDATED. 

EXTENDED MEMORY OUT OF RANGE. 

EXTENDED MEMORY PARITY ERROR. 

EXTENDED MEMORY PARITY ERROR. 

EXTENDED MEMORY READ ERROR. 


On m }irtm mod« ni«nu ppoc«ciur« call, only 
« p«riod. a right paranthasis, or a 
quastian mark (raquasting halp) isay 
fellow the menu salaetlen. 


On a lino raeda manu precadura call, only 
a right paranthasis. a period, a question 
mark (requesting help) or a comma 
followed Py a manu selection may follow 
the proeadura/fila name. 


On a line mode menu procedure call, a 
comma followed the proeedure/fila name, 
but it was not followed by a valid menu 
se 1 action. 


An incorrect separator was used in a 
response to a prompt from a line mode 
interective procedure. 


An incorrect separator was used in a 
response to a prompt from a line mode 
interective procedure. 


OAta transfer between CM and extended 
memory specified an extended memory address 
outside the job field length. 

Parity error detected on extended memory 
flag register operation. 


Make the appropriate CCL 

menu selection in 

response to the 

prompt, or reissue 

the command in the 

correct format. 

Make the appropriate CCL 

menu selection in 

response to the 

prompt, or reissue 

the command in the 

correct format. 

Make the appreepriate CCL 

menu selection in 

response to the 

prompt, or reissue 

the command with a 

valid select ion. 

Enter parameter CCL 

values in response to 

the prompts, or use 

the appropriate 

separators as 

indicated for 

multiple parameter 

value responses. 

Enter parameter CCL 

values in response to 

the prompts, or use 

the appropriate 

separators as 

indicated for 

mu11ip1e parameter 

value responses. 

Analyse the job output lAJ 

end dumps to determine 
the ceuse of the error. 

Inform customer engineer. tAJ 


You ere not velideted for the minimum 
emeunt of control memory roquired whon 
using extondod memory. 

•iob reforoneod oxtendod memory eddross 
outside job field length. 


ECS transfer on a model 176 failed. 
Hardware error. 


See site personnel VALEX 

concerning 
ve 1 idetions. 

Analyse the job output lAj 

end dumps to determine 
the ceuse of the error. 

Inform customer onginoor. lAj 

inform sito enelyst. RECLAIM 




HESSAeg 


SICWIFICAMCE 


ACTieW 


AOUTIWE 


F1I.E NAME CONFLICT. 

FILE NAME CONFLICT. 

FILE NAME CONFLICT. 

FILE NAME CONFLICT. 

FILE NAME CONFLICT. 

FILE NAME ERROR. 


Tritt 5 Am« fii« nemo hos boon spocifiod for 
mere than eno poromotor. 


For tho L072 ceiMRond. tho S and L fllo 
namos aro tho samo. For tho ITEMIZE 
command, tho output and binary filo namos 
aro tho samo. 


Corroct tho command so 
that all filos havo a 
unique name. 

Ronamo oithor output 
filo or filo to bo 
itamizod. 


Tho old filo. roplacomont filo. and tho Specify unique file 

new filo wore not all specifiod by namos. 

unique file namos. 


Eithor you tried to process tuo files 
having tho samo name or you specified 
reserved file name. 


Correct the command so 
all filos havo a unique 
name. 


The samo file name was specified for both Specify the correct file 

tho filo to bo itemized and for tho list name and retry. 

filo. 


File name contains incorrect characters or Ensure that a valid file 

contains mere than seven characters. name is specified. 


FILE NAME MISSING. 

FILE NAME TOO LONG. 

FILE NOT DISK RESIDENT. 

FILE NOT FOUND ~ filonam. 

FILE NOT FOUND OR FAILED CRITERIA • 
fi1ename 


FILE NOT ON MASS STORAGE. 

FILE STATUS NOT SFECIFIED. 

FILE STRUCTURES MOT COMPATISLE. 

FILE TOO LONG. 


FILE TOO LONG. FILE filename AT address. 


FILENAME CONFLICT. 

nnn FILEtS) PROCESSED. 

FIP • ACN acn NOT WITHIN RANGE. 


FIP - CIO ERROR xxi ON fi1enamo, raasen 


The LOsP. LP8PP or LOsX option was 
spacifiod in a CATLIST command, but ne filo 
was spacifiad with tho FN paromotor. 

A file name was Spacifiad that has mere 
then seven characters. 

Tho disk space associated with tho 
specified permanent file has already been 
dropped. 

The designated input file did net exist 
prior to the copy or verify. 


RECLAIM did net process the named file 
because it could not find the file on the 
dump tape or file (for a LOAD or COPY 
operation): it could not find a local or 
permanant file by that name (for a DUMP 
operation): or it found the file, but 
failed to meet ether criterie. 
the file 

filename A file nemo you specified in a 
RECLAIM PF or FN option 

The specified file does net reside on mass 
storaga. 

Yeur SETFS command deas not spacify a file 
stat us. 

varificatien results cannot be guaranteed 
correct when the logical structures of the 
files being verified are net compatible. 

The local file specified for a SAVE. 
NCPLACE. or APPEND command exceeds the 
length el lowed or the direct access file 
Specified for an ATTACH operation in write, 
MODIFY, UPDATE, or APPEND mode oxeoods the 
direct access file length limit for which 
you are authorized. 

The length of the direct access permanent 
file currently being written exceeds the 
direct access file length limit for which 
you ere authorized. 


The first two parameters of the GTR command 
are identical. 


The operation was performed on nnn files. 

A data transfer error has occurred. The 
system has haltad the file transfer. 

acn Application connaetion numbar 

(oetel) 

NETXPR has tarminatad file transfer because 
of a fault while reading or writing tha 
local fila. 

RN CIO arror coda (octal) 

(Rafar to Veluma 4 of tha NOS 
Version 2 Reforonee Set.) 
filename The affected file 

FResen Abbreviated error 

doseription: 

ERROR ON FILE-OPEN. 

DEVICE FULL. 

PARITY ERROR. 

TAPE SLOCK SIZE ERROR. 


Correct and ratry. 


use « file name that has 
Sevan or less characters. 

None . 


If the file should 
have existed, 
reaccess the file and 
retry. 

Cheek to see that a file 
exists with the 
specified file name. 


Copy fila to mass 
storaga and ratry. 

Ratry command with a 
file status parameter. 

None. 


Reduce length of file or 
save as a direct access 
file. 


Reduce the length of the 
file or ask site 
personnel for e larger 
direct access file 
length limit. 

specify different file 
names for the first two 
parameters on the CTR 
commend. 


Nona. 

Inform sito analyst. 


Correct problem end 
retry transfer. inform 
site analyst if 
proDlam parsists. 


LIBEDIT 

L072 

COPYL 

COPYLM 

COPYB 

FCOPY 

ITEMIZE 

LPM 

LISTLB 

PFM 

CATLIST 

COPYL 

PFM 

COPYB 

VERIFY 

RECLAIM 


1 AJ 

MFXLES 

VERIFY 

PFM 

IMS 

GTR 

MFXLES 

FIP 

FIP 


B048B8B0 I 
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MESSAGE 


SlGWirieAMCE 


ACTION 


ROUTINE 


Ftp • CONNECTION OROKEN ON ACN ACn. 

FIR > CONVERT MOOB N/A FOR «i1«nAfR« 

FIR • DISABLE WARNING RECEIVED. 

FIR • GT 4 PILE TRANSFERS INITIATED 

FIR • INITIATING XFR OP fi1an«m« 

FIR • NETOPP DURING PILE TRANSFER. 

FIR • NETXPR ERROR. ALL TRANSFER TABLES IN 
USE . 

FIR • NETXPR ERROR. BAD ATTRIB. kxkx FOR 
COMMAND yy. 

FIR ' NETXFR ERROR. BAD INTERNAL TRANSFER 
STATE : xxB. 

FIR • NETXFR ERROR. BAD PARAMETER 00 : xxB 

FIR • filanama ON INVALID DEVICE. 


Tha natwork connaetion nas baan brekan 
unaxpactadly. Tha systan has haltad tha 
♦ i1 a transfar 

acn Application connaetion nuiabar 

{oet a 1 ) 

Tha application timad out waiting for 
rasourcas to bacoma available. 

filanama Tha affaetad file 


Tha systan has haltad tha fila transfer 
baeausa tha network is shutting down 
inmadiat aly. 

Tha system is attempting too many file 
transfers simultaneously. The system has 
not initiatad the fila transfer you are 
requesting. 

The system has initiated tha transfer of 
file fi 1 onama. 

An internal error occurred during your file 
transfer. The fila transfer was not 
compiatad successfully. 

NETXFR aborted the application after 
finding all internal tables in use. 


NETXFR aborted tha application after 
finding a faulty internal attribute value. 

Attribute value Ihaxadacimai) 
yy Associated command value 

(decima 1 ) 


NETXFR detected an internal fault and 
aborted the application. 

XX Internal transfer state (octal I 

NETXFR detected a faulty 00 parameter in 
the application's NETXFR call and aborted 
the app1ieation. 

XX 00 parameter value (octal) 


File filename is assigned to an 
inaccessible device. The system has 
halted the file transfer . 


filename File being transferred 


rece i ve 


the 


Rerun your job. Inform FIR 
Site enelyst. 


Try agein. If problam FIR 

persists, inform site 
anelyst. 


Retry the file transfer FIR 

efter the network is 
reectiveted. 

Inform Site analyst FIR 

None. FIR 

Inform site enelyst FIR 

Retry transfer. Inform FIR 

site analyst if 
problem persists 

Retry transfer. FIR 


Inform site analyst 
if problem persists. 


Retry transfer. FIR 

Inform site analyst 
if problem persists 


Inform site analyst or FIR 

correct application 
pr egram 


Reassign file filename FIR 

to an accessible device 
and rerun job. Inform 
site analyst if the 
problem persists. 


FIR 


OUTRUT BLOCK NOT DEL ON ACN acn. 


The remote system did net 


Retry the file 


FIR 



MESSAGE 


SICNIFICAWCE 


ACTION 


ROUTINE 


PIP * SYSTEM ERROR. r««son. status. 


PIP • TIMED OUT WAITING FOR NETWORK. 

PIF - TRANSFER OF filanaiaa COMPLETE. 

PIP ' TRANSFER OF filanamo IN PROGRESS. 

FIP - XFR COMPLETE. NO ERR. IDLEDOWN. 

PIP - XFR TERM WITH ERR, IDLEDOWN. 

PL OEYONO MFL. 

FL REOUEST BEYOND MFL (EXTENDED MEMORY). 

PL TOO SHORT FOR PROGRAM. 

FLE TOO SHORT FOR LOAD. 

»««• FORMAT ERROR. 

FORMAT ERROR. 

FORMAT ERROR IN INPUT. 

FORMAT ERROR ON COMMAND. 

FORMAT REQUIRES UNLABELED TAPE. 

FORWARDING JOB MONITOR 

pfn FOUND, 
or 

un FOUND. 

FOUND SECTION sactton. 

•FR* NOT FOUND. 

FROM sjsn: wasoao# 


A system error (fnd)cated by reason) has 
interrupted NETXFR. which is either 
attemptino or abandoning recovery 
(indicated by status). Subsepuent dayfile 
messages indicate whether the file transfer 
completed. 

Ratry tha file transfer 
after correcting the 
problem, er inform 
site analyst. 

FIF 

reason CPU TIME LIMIT. 

PP ABORT. 

OPERATOR DROP. 

OPERATOR RERUN. 

EM PARITY ERROR. 

MASS STORAGE LIMIT. 

I/O LIMIT. 

TERMINAL INTERRUPT. 

Status FIP REPRIEVING 

FIP REPRIEVES EXHAUSTED 



The network failed to respond before the 
time-out period elapsed. The system halted 
the file transfer. 

Ensure that tha network 
and remote system are 
active and ratry the 
file transfer. Inform 
Site anelyst if the 
problem persists. 

FIR 

Self explanatory. 

None. 

FIP 

filename File being transferred 



Self explanatory. 

None. 

FIP 

filename File being transferred 



The network is shutting down, but your file 
transfer completed successfully. 

None . 

FIP 

The network is shutting down and your file 
transfer ended unsuccessfully. 

Retry the file transfer 
when the network becomes 

act i ve. 

FIP 

Request field length exceeds maximum 
field lengt h. 

Ineraase MFL via MFL 
raquast er ineraase your 
va1idation FL. 

lAJ 

Extended memory field length requirements 
for the job stop exceed the extended memory 
field length allowed. 

Increase job step 
extended memory field 
lengt n. 

IMA 

The job's field length is too short for the 
program. 

Rerun the job with a 
largar fiald Isngth 
spacifieation. 

1 AJ 

You ettorapted to load extended memory dote 
beyond the job's extended memory field 
length. 

None. 

lAJ 

Your entry is not recognized as valid 
system input. The line of input is 
d isregarded. 

Correct the entry in 
error. 

MOOVAL 

Message resulted from one of the following: 

• The GTR command format was incorract. 

An incorrect library type wes specified. 

R record name 1engar than savan 
characters was spacifiod. 

Refer to the description 
of tho GTR command. 

GTR 

Tha Charge and/er project numbers road 
from the input file ware not in tha 
correct format. 

Enter charge and 
project numbers in 
the correct format. 

VALEX 

An arror was dotoetad in the format of tha 
command. 

Chaek tha dascriptien of 
the command format. 

1AJ 

Tha format spaeifiad IF) is valid only for 
unlabeled tapes. 

Tha tapa must be 
assigned as an unlabalad 
tape. 

RESEX 

The su^zitted job is being forwarded. 

None. 

HELL07 

The file name specified on the CATLIST 
(L0*0) command was found in your catalog or 
tha file name or user name specified on the 
CATLIST (LO*P) command was grantad 
pormission. 

None. 

CATLIST 

This is tho last tin# of a thraa-lina 
mossage: 

None. 

1MT 

MULTIFILE NOT FOUND, filanamo AT addrass. 
REQUESTED SECTION saetien. 

FOUND SECTION section. 

Tha system has raaehod tha and of a 



multifile set. 



The spocified string was not in the 
deyfile. If your job is interactive, you 
will get e full dayfile dump. A dayfile 
dump is not produced for a batch job. 

Retry with a corrected 
FRsstring. 

DAYFILE 

Another interactive user with the jsn sjsn 
sant this message using the DIAL command. 

If validated to use the 
access subsystem, you 
may raspond to this 
massage using DIAL. 

lAFEX 


L 
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MESSACE 


SICWIFICAACE 


ACTiail 


KOUTIME 


FROM NOP. . .mossAgo. 

FUNCTION REJECT. fMAHAMA AT A0drASS. 
FWA .GE. LWA«1. 

FWA . 6T . LWA 

FWA/LWA .CE. FL. 

GLfiOAt klBRARV DIRECTORY DEFECTIVE. 
CI.OBAL LIBRARY DIRECTORY NOT FOUND. 


GLOBAL LIBRARY SET CLEARED. 

CO FROM JOB jsn 

CO FROM OPERATOR 

6TR ERRORS. 

H VALUE INCORRECT. 

HARDWARE RERUN THRESHOLD EXCEEDED. 


MOST AVAILABLE CONTROL CHARACTERtChar 

ENTER INPUT TO CONNECT TO HOST 


TH# network eparater sant this nassaga. 

If necessary, you can 
respond using the MS 
conneand. 

C$ 

Function was rajaetad (pessioia hardware 
prablam). 

Inform site analyst. 

1MT 

The first ward addrass paraieatar was 
oreatar than the last ward addrass 
parameter on OMP. OMD. DMPECS. OMOECS, LDC. 
or PBC ceiBBand er DMP. OMD. DEO. or OEP 
system requests. 

Correct error end retry. 

CPMEM 

You specified a first word address 

B^'Ratar than the last word address. 

Correct addresses end 
retry. 

DEBUG 

Either first ward address parameter ef LOC 
or the last word address of LOC er PBC was 
greater than er equal to your field length. 

Reduce FWA end/or LWA 
and retry. 

CPMEM 

The global library directory file ZZZZZLD 
contains errors- 

Regenerate the library 
dir act or y file. 

1AJ 

Global library set processing is active, 
but there is no directory file CZZZZZLD). 

Enter the LIBRARY 
conmuind with no 
peremeters te deer the 
global library set 
processing, or 
regenerate ZZZZZLD by 
reentering the LIBRARY 
commend with the 
appropriata i ibraries 
speeifiad. 

1AJ 

An infernetive message. 

None. 

LIBRARY 

A 60 command was issued to the job by the 
job jsn. 

None. 

1RI 

A 60 command was issued te the job by the 
consele operator. 

None. 

1RI 

There are errors on the GTR command. 

Cheek the description of 
the GTR command. 

GTR 

The H parameter was sere or greater than 
the buffer length. 

Corroet paremetar and 
retry. 

LQ72 

The job has been rerun the maximum number of 
tines due to e hardware error. The leaximum 
is n>l. Where the default is n*2 {defined by 
HRTL in common deck COMSMSC). 

Analyze job dumps, 
ma int ananea 
registers, end the 
error leg er HPA 

1 AJ 


raports te cSAtarmlna 
tha causa of tha 
arror . 


Your soloctao host <s ovoiloolo. entor any input to 

^nltiata vaur eonnactian 


CCP 



MESSACe 


SICMIFICAWCE 


ACTION 


AOUTIWE 


I/O LIMITS 


EXCEEDED. 


I/O ON EXECUTE ONLY 


FILE. 


I/O SEQUENCE ERROR. 


Your v«lid«tttO job I/O limits ti«v« boon 
•xcoodod during tha currant RECLAIM session. 


You attaraptad to lead an overlay from an 
axaeuta*enly file, but your main overlay 
was not loaded from tna seme file. 


Action was requested on a local file that 
was busy. 


Log in and retry the 
operation. If it fails 
again. checK your 
validated I/O limits for 
tape mounts to ensure 
that you have net 
exceeded your limits- 

Oo not attempt to 
load overlays from an 
execute-only file if 
tha main overlay was 
not loaded from tha 
same file. 

Write a PSR. 


I/O SEQUENCE ERROR ON FILE filename AT 
address. 

IDLE 

ILLEGAL FW SPECIFICATION • IGNORED. 

ILLEGAL USER. 

cmd ILLEGAL VALUE 

IMPROPER ACCESSIBILITY. 

IMPROPER LOGIN, TRY AGAIN. 

IMPROPER VALIDATION. 


IMPROPER VALIDATION. 
INCORRECT ABORT CODE xx. 


INCORRECT ACCESS LEVEL FOR EQUIPMENT. 


INCORRECT ARGUMENT. 


INCORRECT ARGUMENT VALUE. 


INCORRECT CNARACTER. 


INCORRECT CHARACTER NUMBER. 


Veu attempted to perform e function on e 
local file before another function on the 
seme file was complete. 


The system is waiting for you to enter a 
command. 

Tha value specified with the PW commend 
option is not numeric. 

Four unsuccessful attempts at login were 
made after which the terminal was 
disconnected from the system. 


Vou specified an invalid value in tha 
tarminel dafinitien commend cmd. 

Vou did net specify tha correct file 
accessibility on tha LABEL command or 
macro, or volume accessibility uas sat and 
you attempted to assign tha tape as 
unlabelod from a nen-systam origin job. 

You nave entered an incorrect family name, 
user name, or password during login. 

Veu entered incorrect or insufficient 
ve 1 idation informat * on. 


A CHARGE eomaand is required to continue. 

A batch job was entered from a card 
reader or routed from another meinfreme 
which could net execute for unknown 
reasons. 

Veu have spacified a laval eutsida of tha 
equipment access level limits. 


On a SETFAL. SETJAL, SETPFAC. or SETPFAL 
command, you spacified an incorrect 
erqument other then access level or access 
category. 

A directive keyword was equated to an 
incorrect value such as e file name longer 
than saven characters or an alphabetic 
character in a numarie string. 

Ineerract charactar read from t-traek 
tapa. If a 1 is dot actad in bit 7 of a 
translatad character, the character is 
incorrect. The deyfile message STATUS 
ERROR, filename AT address precedes this 
message end specifies the file Ifileneme) 
end the address. 


In e copy request, one of the fallowing was 
detected: 


Last charactar position was lass than 
first character position. 

Last charactar position was greater then 
ISO. 

Either first chereeter position or lest 
chereetar position was unrecegnitable. 


Modify program to wait 
until each function is 
eomplota before 
attempting anether. 

Enter a command. 


Correct the peremeter 
end retry. 

Obtain accurate login 
infermation before 
attempting to log in. 
Inform site analyst if 
problem persists. 

Choose e valid value 
(refer to appendix J). 

Ensure accuracy of 
r equest. 


Cheek peremetars end 
r at r y . 

Verify that the USER 
command precedes rest 
of job (followed by 
CHARGE, if required) 
and is tho first 
command after tha Job 
eenmiand. 

Enter a CHARGE commend. 

Contact site 
personnel and write a 
PSR. 


Use access laval within 
required equipment's 
access level limits or 
use equipment with 
access level required. 

Reenter the command with 
correct arguments. 


Correct tha value and 
retry. 


Verify the following: 

- Tepo contains coded 

date rather then binary. 
If binary, use binary 
copy operation. 

• Tape is ASCII rather 
then EBCDIC. If 
EBCDIC, specify CVsEB 
on LABEL commend. 

• Tape is T-bit rather 
then B-bit ASCII. If 
B-bft, use FCOPV to 
convert to 7-bit. 

If ell the above ere 
verified (that is. 
tape is 7-bit ASCII), 
notify site analyst. 

Ensure eeeureey of 
commend parameters. 


RECLAIM 

1 AJ 

LFM 
PFM 
1 AJ 

IMS 

I AFEX 

ITEMIZE 

NETVAL 

NETVAL 

RESEX 

lAFEX 

1 AJ 

1 AJ 
I AJ 

RESEX 

MLSEXEC 

RECLAIM 

IMT 


COPYC 


BOaSBBBQ L 


B-Z7 



WeSSASE 


SlCWiriCANCE 


ACTIOM 


ROUTINE 


INCORRECT 

COMBINATION OF ON/SI. 

SI was specified end ON was not. If Si is 
specified, then ON must also be specified. 

Specify ON and rerun tho 
job. 

LtSTLO 

XX INCORRECT COMMAND 

The charaetars xx must be a terminal 
definition mnemonic or interactive status 
command. 

Ensure tha accuracy of 
your entry and retry. 

spacifiad a CHARGE ceawMind 

CCP 

INCORRECT 

COMMAND. 

The system could not idontify the command. 

Check validity of 
commend. 

1AJ 

INCORRECT 

COMMAND. 

One of tho following occurred: 

You spocifiad a CHARGE command 
with an incorrect poramotor er 
without a terminator. 

You entered en incorrect commend or a 
commend you wore net validated to use. 

The job was not in e stato to process 
the command at that time. 

Use tho LIMITS 
command to check your 
validation, and if 
you are validated to 
use the commend, 
correct the format of 
the command and 
reenter it. 

lAFEX 

MOOVAL 

INCORRECT 

COPY . 

File and/or conversion typos do net meet 
copy requirements. 

Correct error and retry. 

COPTS 

INCORRECT 

COUNT. 

The copy file count is nennumorie er 

Specifieo as sare. 

Correct command and 
retry. 

COPYC 

INCORRECT 

CPU PRIORITY VALUE . 

You specified e CPU priority value which 
exceeds the maximum value allowed. 

Reenter the cenmand with 
a valid CPU priority. 

CONTROL 

INCORRECT 

OC CODE. 

The disposition code specified en the command 
is net valid. 

Correct and ratry. 

LOI 

INCORRECT 

OC PARAMETER - dC. 

You spoeifiod an incorrect OCsdc 

Correct the 

OCsdc parameter 

DROP 

OCET 

INCORRECT 

DEVICE REOUEST. 

The device typo IR parameter) specified en 

Examine auxiliary device 

PFM 


INCORRECT END OF 408 OFTION SFECIFIED. 
INCORRECT ENTRY. 

•INCORRECT ENTRY, TRY AGAIN* 

INCORRECT EOUIPMENT. 


INCORRECT EOUIFMENT ON FILE fi1«n«n« AT 
Address. 


A raquASt for An AUxiliAry dAvicA CAnnet be 
reeegnizAd or dees not exist in the 
system. If the Auxiliery device specified 
by the PN perAmeter is net the seme type as 
the system or job defeult. the R peraneter 
must be included. 

The option specified is net velid for a 
neninterActive job. 

You entered something ether then CO, 

RELIST, or A vAlid job sequence name. 

You entered incorrect cheracters in 
response to an SRU limit or time limit. 

Equipment specified dees net exist or is 
not A1 loved (for exemple, en intereetive 
tereinel is requested from ether then 
intereetive origin er a tape is being 
requested xith the RCOUEST macro). 

A system error. 


request end ensure its 
Accuracy. 


Retry with a different CFM 

optien. 

Enter CO, RELIST, er a RECOVER 

valid job sequence name. 

Enter correct characters. lAFEX 


Ensure that file resides LFM 
on A legal equipment RESEX 

type. 


Inform site analyst. 


INCORRECT ERROR EXIT ADDRESS. 

INCORRECT EXTERNAL CALL. 

INCORRECT FILE MODE. 

INCORRECT FILE NAME filename AT Address■ 


INCORRECT FILE STATUS. 
INCORRECT FILE STATUS. 

INCORRECT FILE TYRE. 


pfn INCORRECT FILE TYRE. 


Error exit address is beyond tho job's 
current field length. 

RESEX did net reeegnite en external call. 

You tried to unlock e file that was 
Attached in exoeuta^only mode. 

The file nema does net conform to 
ostablished rules. The file name mey 
heve e maximum of seven Alphanumeric 
charactors and must be left* just Ifiad 
with binary zero fill. 

Spocifiad file status is incorrect. 

You specified e file status in a SETFS 
ceoifiend other than AD er NAO. 

The specified file is of e type not ellowod 
in the requested operation. Possible 
ceuses fnetudo attempts to do tho following: 

Change e nonlocal file to file type 
1ibrery. 

* Designate a diraet eeeess file as tha 
prieary file. 

* Route the primary fila. 

* Change the access lave) of a nenleeal 
f i Te. 


None. 

1AJ 

Inform site analyst. 

RESEX 

None. 

LFM 

Use valid file name. 

IMS 


Chack value. 

LFM 

Retry with e proper file 
status parameter. 

MFILES 

Verify that the file 
type is appropriate. 

LFM 


The operation requested cannot be 
perferaed en tho specified file because 
it is the wrong file type. This message 
is issued when one of tha following 
occurs: 


•You attempt to define a direct eeeess 
file with the seme local file name as a 
file currently assigned to the joe that is 
of a file type ether then local. 

•The local file being saved is a direct 
access file etteehed in read/allew modify 
er reed/allow append mode. 


Implemont tho action 
that applies: 

Def{no the file 
using a unique name. 
Return the file 
and reattach it in a 
different mode. 


PFM 


■ •EO 


I 





MESSAGE 


SICNIFICAWCE 


ACTIOW 


WOUTIWE 


INCORRECT FILE TYRE FOR SFECIFIEO CHARACTER 
SET . 

INCORRECT I/O REOUEST ON FILE AT 

Address• 

INCORRECT ID CODE. 

INCORRECT INPUT FILE. 

INCORRECT INPUT FILE SYSTEM SECTOR. 


ASCFL or EBCFL wes specified «S the 
cherpcter set for e neri'tope file or eny 
ether eherocter set for « strenoer t«pe 
f i 1e. 

The system ceuio net recognize the 
specified function cede or the code was 
net valid for the type of device to which 
the file was assigned. You attempted to 
write on a local file that resides on a 
device whose highest access level is below 
the current access level of your job. The 
system provides a dump of the FET on file 
OUTPUT. 

An identifieation code not in the range 
e-S7B or 77B is present on the LDI command. 


An attempt was made to pack a file that is 
assigned to an interactive terminal. For 
example, file INPUT for an interactive 
origin Job cannot be packed. 

Job terminated without exit processing due 
to system error. 


INCORRECT INSTRUCTION. 

INCORRECT JOB ORIGIN TYPE FOR TRMDEF. 

INCORRECT JSN ARGUMENT. 

INCORRECT LABEL TYPE, filename AT address. 

INCORRECT LIO. 

INCORRECT LINE LENGTH. 

INCORRECT LIST OPTION. 

INCORRECT LOAD ADDRESS. 

INCORRECT LOCAL FILE NAME ' Ifn. 

INCORRECT MODIFICATION OF filename AT address. 

INCORRECT NOISE SIZE ON filenam. 


The CPU attempted to execute an incorrect 
or unavailable instruction. 


The TRMDEF command was entered from a job 
that was not of interactive origin. 


The JSN specified is not four characters. 

Incorrect label type. The only valid label 
types are ANSI labeled and nonstandard 
labeled. 

A batch Job was enterad from a card 
reader or routed from another mainframe 
with an ST parametar on the job command, 
but the value specified for the ST 
parameter was net corraet. 

Either of the felleving out of bounds 
conditions exists with respect to the Ix, 
NX, Ox, and H parameters of the L072 
cenraiand: 

(OxeNx).6T.H 

(XxeNx).CT.(touffer length) where i .LE. 

X .LE. b 

The list option specified in a CATLZST 
command is incerract. 


Tha lead addrass is less then 2. 


The FNtifn paremeter on the 06ET command 
contains an arrer. 

Ifn Th« local fila name for the 

queued output 

Either you have attempted to shorten a 
modify only file or the file cannot be 
modifiod at all. 

Noise size on S. L, or F format tape does 
net meet copy requirements. 


INCORRECT -NR- PARAMETER. You specified something ether than NR to 

inhibit the rewinding of the file. 

INCORRECT OP PARAMETER > op. YOU specified an incerract OPsep 

paramat or. 

INCORRECT «/« OPTION. An incorrect command option followed the 

Start . 


INCORRECT OPTION ARGUMENT. 

INCORRECT OPTION X. 


Command contains an incorrect argument for 
an option. 

The option specified is net defined for 
ENOUIRE. 


INCORRECT OUTPUT FILENAME. 


Command contained a file name that was 
mere than seven characters long or 
contained a non-alphanumerle eharaetar. 


Correct the parameter FCOPY 

and retry. 


Verify CIO function cede IMS 
being used. Lower the 
access level of your 
job, if possible, or 
raise the access level 
of the file. 


Reissue the request with LDI 
the correct 
identification cede. 

verify that the file PACK 

being packed is net 
assigned to an 
interactiva terminal. 

Contact your site lAJ 

support or CYBER 
Software Support. 

Analyze job output and tAJ 

dumps to datormine the 
cause of the error. 

Retry from an TRMDEF 

interactive origin job 
or remove the TRMDEF 
command. 

Fix JSN and retry. CLASS 

Use correct label type. IMT 


Correct ST parameter lAj 

end retry. 


Correct paremeter and L072 

retry. 


Refer to description of 
the CATLIST command for 
valid list options. 

CATLIST 

Specify larger load 
address and retry. 

1AJ 

Correct the parameter. 

OGET 

Determine whether the 
file can be modified. 

IMS 

For COFY, ensure that 
noise size on input file 
is greater than or- equal 
te that of the output 
file. For COPVB, 
correct noise size te 
moot requirements end 
retry (noise size of t 
for 7‘treek or s for 
9‘treek tapes is 
required for X .and SI 
format cenvorsiens]. 

COPYB 

Corraet the NOTE command 
and retry. 

NOTE 

Correct the 

OP>ep parameter. 

OGET 

DROF 

Correct the option end 
retry. 

MFILES 

Check command 
description and retry. 

CLASS 

Check paramators on 
conmiand and retry. 

ENOUIRE 

Correct file name end 

CLASS 


retry. 


L 






MESSACe 


SICWIFICAWCE 


ACTIPii 


EOUTINE 


INCORRECT RARAMETER. 

INCORRECT PARAMETER. 

INCORRECT PARAMETER. 

INCORRECT PARAMETER LENOTM OR 

INCORRECT PASSWORD. 

INCORRECT PASSWORD. 

INCORRECT eUEUe SPECIFIED. 
INCORRECT OUEUE TYPE. 

INCORRECT 'R/NR- PARAMETER. 
INCORRECT REPLY LIMIT REACHED. 
INCORRECT REQUEST. 

INCORRECT REQUEST. 

INCORRECT RESOURCE COUNT. 

INCORRECT SERVICE CLASS. 

INCORRECT SERVICE CLASS. 

INCORRECT SERVICE CLASS. 

INCORRECT SORT PARAMETER. 

INCORRECT SYNTAX. 

INCORRECT TAPE DENSITY. 

INCORRECT TAPE FORMAT. 

INCORRECT TERMINAL. 

end INCORRECT TERMINAL CLASS 


SEPARATOR. 


MesSAQO r«sult«d from one of the following: 

Perameter value was out of range. 

You specified a parameter that cannot be 
included on the command. 

* Command was incorrect. 

You specified an incorrect parameter on the 
current command. 

The s or L parameter was ontorad as sero on 
the L072 command. 


You specified a parameter longer than seven 
characters or used an incorrect separator. 


One of the following PASSWOR command errors: 

• The new password entered is greater than 
seven characters or contains an 
incorrect character. 

- The incorrect old password was specified. 

One of the following PASSWOR command 
errors has occured: 


-- The old password entered did net 
match the actual old password. 

The new password entered was 
either toe long, tee short or 
contained incorrect characters. 

You specified an incorrect disposition cede. 


System error. 


You entered a value ether than R or NR for 
the second parameter of the BLOCK command. 

The number of consecutive incorrect entries 
exceeds the limit. 

No parameters were specified on a DMPECS or 
DM0 ECS c emmand. 

A program issued a request (such as a 
MEMORY request) in which the request word 
was outside the job's field length. 


Total resource deawnd exceeds maximum 
allowed, as defined by installation 
parameter MAXO (defined in RESEX). 

On the CHVAL command, the two cherecter 
service cless was not veUd for the user 
or net valid for the origin type. 

You entered an invalid service class for 
tho SC peremoter of tno CLASS conmend. or 
tno UC peremotor of tho CHVAL command. 
Either you are net validated to usa the 
sarvica class you spocifiod or the 
service class is net valid for the origin 
type of tho job you specified in the JSN 
paramatar. 

A batch job was antored from a card 
'*oodor or routed from another mainframe 
with an ineerraet service class specified 
on the job command. 

An ineerraet parameter has been specified 
on the SORT eeiemand. 


A required paramatar is missing, paramatars 
era givan in tha wrong order, or an 
incorrect separator has baan aneeuntarad. 

An incorrect NOS tape density has bean 
requested for the dump option. 


An incorrect NOS tape format has Dean 
requested for tha dump option. 


YOU have exhausted your login retry 
count. 


Tha value you spocifiod in tha terminal 
definition command emd is not valid for 
your tarminal. 


Ensure accuracy of 
command. 


Ensure the accuracy of 
your paramatar. 

Retry command, adding a 
correct S or l parameter 
value. 

Ensure the accuracy of 
your parameter 
specif teations. 

Correct error and retry. 


Correct error and 
rat ry. 


Retry with valid 
disposition code. 

Write a RSR and include 
support materials to 
allow COC to duplicate 
the problem. 

Correct the R/NR 
peremetar and resubmit. 

None. 


Retry job with corrected 
command. 

If the messege occurs 
after you entered a user 
broak 2. ignore tha 
mossaga. If net. 
correct the program. 

Reduce resource demands. 


Correct and retry. 


Correct tha service 
class entry and 
resubmit. 


Correct and retry. 


Consult description of 
SORT commend for valid 
paramatars. 

Check proper command 
format and raonter the 
command. 

Correct the tape 
specification and 
reenter. 

Correct tha tape 
spoeification and 
reenter. 

Cheek your family 
name, user name, and 
password. if tha 
preblom porsists. 
contact your sita 
administrator. 

Cheesa an appropriate 
value (refer to appendix 
J). 


CATLIST 

DROP 

lAFBX 

LISTL8 

Q6BT 

CONTROL 

CTR 

L072 

CONTROL 

MDOVAL 

PFILES 

MOOVAL 

SUBMlT 

ENQUIRE 

NOTE 

RECOVER 

CPMEM 

IMA 

RESEX 

MOOVAL 

CLASS 

1AJ 

SORT 

lEOIT 

RECLAIM 

RECLAIM 

lAFEX 

CCP 
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MESSAGE 

INCORAECT TERMINAL REQUEST. 

INCORRECT TERMINAL TYRE ROR TRMDEF. 
INCORRECT USER. 

INCORRECT USER COMMAND. 

cmO INCORRECT VALUE 
INCORRECT VALUE FOR • xx. 

INCORRECTLY-FORMATTED LIBRARY. Iname. 

INCORRECTLY FORMATTED TRMDEF data. 

INDEX TOO LARGE ON OFEN. FILE filaname AT 
adOrass. 

INITIAL COMMAND LIMIT. 

INITIAL MESSAGE LIMIT. 

INFUT DISCARDED .. 

INPUT ERROR LIMIT. 

INFUT FILE ERROR. 

INPUT FILE IN NO RERUN STATUS. 

INPUT FILE IN RERUN STATUS. 

INFUT FILE NOT FOUND. 

INPUT LOST, REENTER LAST LINE. 

•INPUT* NOT ASSIGNED TO TERMINAL. 

INSERTED LINES OVERLAP EXISTING LINES, AT 
nnnnn. ENTER Y TO CONTINUE OR N TO STOP. 

INSUFFICIENT RESOURCES ON SYSTEM. 
INSUFFICIENT RESOURCES ... RE-ENTER 
INSUFFICIENT STORAGE FOR LIBRARY GENERATION. 
INTERACTIVE JOB STEF. DUMP DISABLED. 

pfn INTERLOCKED. 

•INTERRUPTED* 


SIGNIFICANCE 


Infernativa fiiASsaga indicating that an 
unidBntifiAd paguost was Ancountarad or 
auto racall was not raquastad Oy tha 
calling job. 

The TRMDEF command was antarad from a 
tarminal that was not a network terminal. 

Four unsuccassful attampts at login ware 
made aftar which tha terminal was discon- 
hacted from tha systam. 


The usar name or password could not ba 
vaiidatad. or a sacondary USER command to a 
diffaront family was attamptad and you ara 
net vaiidatad to changa families. 

Yew spaeifiod an invalid value in the 
terminal definition command cmd. 

An incorrect value was Specified for 
attribute xx. 

Thera is an arror in the ULXB record of 
file Inaraa. Tne system does net create a 
directory for this file. 

A tarninal definition paramator spaeifiad 
on the TRMDEF command or via the 0016 
control byte was not correct. 

Fop an OPEN function, tha random index 
length axcaadad the index buffer size. 


Tha number of commends procassad by tne job 
exceeded the limit for wnicn you are 
validated. At this point, an additional 
eignt commands are allewad for error 
processing. 


Monitor has detected that tne message limit 
for tha job has expired. 

The network has discarded tne last input 
from your terminal. May be caused by 
entering a user break or interactive status 
command while awaiting a response to a 
previous user break or interactive status 
command. 

You have enterad incorrect charge end 
project numbers several times. 


An error on tha input file was eneountarad 
during tha unpack operation. 

Informative message. 

Informative message. 

The input file must be either a local or an 
attached direct access file. 

Your last line of input was lost due to an 
lAF internal error. 


You anterod tha PASSWOR commend from a 
nen-terminal input fila when password 
randomixation is raquirad. 

Tht MOVE, OUP, or READ command cannot be 
completed without line number overlap 
processing. The processing will begin at 
line nnnnn. 

Resource demand exceeds the number of units 
physically available on the systam. 

The system has insufficient resources to 
handle the current raguast. 

Additional mamery is raguirad for tho 
LXB6EN command. 

You entered a mamery dump command directly 
from a terminal. This is not allowed. 


The file is currently net eveileble for 
WRITE. MODIFY, UPDATE, or APPEND modes of 
access because a system utility has 
attached the file in utility mode. 

Infermative message indicating a usar 
break one has baan detected. 


action routine 


Correct erroneous TLX 

reguest or rewrite 
program to use 
r eea 11 . 

Retry from a network TRMDEF 

terminal. 

Obtain eecurata login NVF 

infermation before 
attempting to log in. 

Inform site analyst if 
problem persists. 

Verify that the user CFM 

name and password ere 

valid. 


Choose a correct value CCP 

Irefer to appendix J]. 

Correct and retry. TRMDEF 


Correct the error in the LIBRARY 
ULIB record of ineme. 


Ensure eecurecy of entry lAFEX 
and retry. 


Set EP bit in FET+i to IMS 

get error status without 
abort or increase index 
buffer si so. 

Split the job into two 1AJ 

or mere jobs, reduce the 
number of commands in 
the job, or reguast a 
larger command limit 
from site personnel. 

Decrease job size or lAj 

inerease limit. 

Reenter your last input. CCP 


Enter another CHARGE VALEX 

eernmand specifying 
valid Charge and 
project numbers. 

Correct and retry. L072 


Nona. OFM 

Nona. PFM 

Create the file and FCOPY 

retry. 

Reenter the last line. lAFEX 

If the error recurs, 
inform site analyst or 
customer engineer. 

Resubmit tha PASSWOR MODVAL 

commAnd in response to 
the System prompt. 

Type V to complete the lEDIT 

edit command or type N 
to terminate the edit 
command. 

Reduce resource demand. RESEX 


Retry tha reguast. HELL07 


Increase field length LIB6EN 

and retry. 

To get a memory dump lAJ 

from an intoraetive job, 
place tha dump command 
in a procedure or in an 
ENTER commend. 

Retry operation later. FFM 


None. lAFEX 


BOASBiBQ L 


B-3- 



MgSSACE 


SlClilFlCAtlCE 


ACTIOti 


ROUTIWE 


INVALID APPLICATION, TRY AGAIN. 

INVALID COMMAND 

INVALID DISPLAY DATA FROM SCOPE 2 

pfn IS DIRECT ACCESS. 

IS EXECUTE ONLY. 

pfn IS INDIRECT ACCESS. 

ITEMIZE COMPLETE. 


TH« r«qu«st«d «ppne«tien is unknown or 
unovAilablo to tho usAr . 


Tlio usor has Issuotf an invalid eonmand to 
MELLD7. 

A hardware or systan error oeeurrod. 


An Indiroet aecass file oporatien was 
attOMptod on a diraet aceoss Pi To. 


The specifiad local file cannot be accessed 
by SAVE. REPLACE. APPEND or DEFINE Since it 
is an execute^only file. 

A diraet access file operation was 
attempted on an indirect access file. 


Specified precessinp is finished. 


Check the accuracy of 
the entry. If problems 
persist, contact 
installation personnel 
concerninp validations. 

Check the command and 
reenter. 

Reenter the command. If 
the same message is 
returned, inform the 
Site analyst. 

Use the appropriate 
direct access file 
request. 

None. 


Use the appropriate 
indirect access file 
request. 

None 


ITEMIZING XXXX 


Record xxxx is being processed. 


None. 


ITF. ACN aen, APPLICATION LINKAGE ERROR WITH The host physical identifier pid has detected Inform site analyst. 
HOST pid. one of the following anomalies on the 

CN acn, REASON CODE > nn • xxxx. application connect ion number acn: 


nn xxxx 


0 1 

UNRECOGNIZED COMMAND. 

oz 

INVALID QUALIFIER. 


03 

INVALID ATTRIBUTE. 


04 

REQUIRED ATTRIBUTE 

MISSING. 

05 

CONNECTION TIMED OUT, 

OS 

FC/BRK RECEIVED. 


07 

FC/NAK RETRY COUNT 

EXCEEDED 

04 

BLOCKS OUT OF SEQUENCE. 

OS 

UNEXPECTED COMMAND. 



ITF. ACN aen. APPLICATION LINKAGE REJECTED EY Message indicates ITFS application on ramete If problem persists. 
HOST pid. host physical identifier has rejected linkage inform site analyst. 

request. 


ITF. ACN acn. 


RETRANSMITTING TO HOST 


P 


id. 


ITF. ACN aen. TRANSMISSION RESUMED TO MOST 
pid. 


ITF. CONNECTED TO HOST pid ON ACN c/TCN yy. 


ITF. COULD NOT CONNECT TO HOST pid. 
ITF. REASON CODE * nn • xxxx. 


ITF, COULD NOT CONNECT TO RHF SUBSYSTEM. 
ITF, REASON CODE : nn - XXXX. 


ITF. HOST pid MAS RESPONDED. 

ITF, NAM NETWORK IDLEOOWN IN PROGRESS. 


ITF. RHF NETWORK IDLEDOWN IN PROGRESS. 


acn Application connection number 

pid Physical identifier 


The RHF subsystem has repeatedly rejected 
the transmission of a network block by ITF. 

acn Application connection number 

pid Physical identifier 

ITF has successfully transmitted a network 
block which had been previously rejected by 
the RHF subsystem. 

acn Application connection number 

pid Physical identifier 

Message indicates state of terminal 
eennaetion. pid is the remote host, c is 
tho RMF connection number, and yy is the 
virtual connect ion number. 

ITF was net able to establish an RHF 
eennaetion to remote host pid due to one of 
the following conditions: 

nn xxxx 


oi 

LID UNKNOWN TO SUBSYSTEM 

OZ 

REJECTED 

BY HOST. 

03 

NETWORK 

RESOURCE LIMIT. 

04 

SERVICER 

UNAVAILABLE. 

OS 

PATH DISABLED OR DOWN. 

OS 

HOST NOT 

RESPONDING. 

other 

CONNECTION REJECT. 


ITF was not able to establish 
ceiMsunicat ions with the RHF subsystem due 
to one of the following conditions: 


nn 


Cl 

02 

03 

Other 


SUBSYSTEM UNAVAILABLE. 
ITF UNAVAILABLE. 

ITF DISABLED. 

HETON FAILURE. 


Indicetos stete of eennoetien to host pid. 

The operator hes initiated subsystem 
idledown. ITF will net accept any naw 
eennoetiens. 


Tho operator has initiatad subsystem 
idledown. ITF will not accept any naw 
connect ions. 


If problem persists, 
inform site analyst. 


Nona. 


None. 


If problem persists, 
contact your local 
operator to ensure 
RHF subsystem and the 
LCN ere eperatienel. 
end/er epereter for 
remote host pid to 
ensure RHF subsystem 
end the ITF servicer 
epplieetien ere 
eperetione 1. 


Contact local operator. 


None. 
None. 


None. 


NVF 

HELLOT 

OUEUE7 

PFM 

PFM 

PFM 

ITEMIZE 

ITEMIZE 

ITF 


ITF 

ITF 

ITF 

ITF 

ITF 


ITF 

ITF 

ITF 

ITF 




MESSAGE 


SICWIPICANCE 


ACTIOW 


HOUTIWE 


ITP, RHF NETWORK SHUTDOWN. 

tTP. Tnnnn, TERMINAt CONNECTION ABORTED BY 
HOST pfd. 

ITF, Tnnnn, TERMINAL CONNECTION ABORTED TO 
MOST pid. 

ITF. Tnnnn. TERMINAL CONNECTION ENOCD BY 
HOST pid. 

ITF, Tnnnn. TERMINAL CONNECTION ENDED TO 
HOST pid. 

ITF, Tnnnn. TERMINAL CONNECTION REJECTED BY 
HOST pid. 

ITF, TERMINAL TIMEOUT. 

ITF. TERMINAL WILL DISCONNECT IN ONE MINUTE. 

ITF, WAITING FOR HOST pid TO RESPOND. 

2X OR OX NOT DEFINED. 

JOB ACTIVE. 

JOB ALREADY WAITING ON SERVICE CLASS. 

JOB CANNOT ACCESS FILE. 

JOB COMMAND ERROR.(jobn«ra«) 


JOB COMMAND ERROR. 

JOB DROP IN PROCESS 

JOB HUNG IN AUTO RECALL. 

JOB HUNG IN AUTORECALL 

JOB IN NORERUN STATE ON RECOVERY, 
or 

JOB IN NO RERUN STATE ON RECOVERY. 
JOB NOT DETACHEO. 

JOB NOT FOUND. 

JOB NOT RECOVERABLE. 

JOB NOT RERUN. 

JOB NOT SYSTEM ORIGIN. 

JOB NOT VALID ON REMOTE MAINFRAME. 

JOB NOT VALIDATED TO USE LINK. 


JOB REPRIEVED. 
JOB RERUN. 


Tho subsystoffl is torminoting intmodi «t oly. 
All eennoctions Ar« obortod. 

M«5S«g« indicatos stato of torminal 
connoction. 

Mossago indicatos state of torminal 
connection. 

Message indicates state of terminal 
connection. 

Message indicates state of terminal 
connect ion. 

Message indicates state of terminal 
connection. 

Terminal inactivity forced disconnection. 

Due to lack of activity, your terminal will 
be disconnected. 


Message indicates state of connection to 
nest pid. 

pid Remote nest identifier. 

Tne Ix or Ox parameter wes not specified in 
cenjunetion with the Nx perameter on an 
L0T2 command. 

The system is unable to process the command 
becausa the previous command has not 
completed. 

Change cannot be made because the job is 
already waiting for a CLASS command in the 
job to complete. 

The permanent file being processed hes 
either an access level or access category 
that is net valid for your job. 

The Job command of a routed job contains an 
err or. 

jebname First 20 characters 
of the Job command 
in error. 

The Job command on the file being submitted 
is in error. 


You have issued a DROF.J request which is 
being processed. 

System error. 

System detected an autcreeall call to an 
incemplata word and thara was no activity 
to maka the word complete. 

Identifies a job recovered on level o er 
level 3 deedstert that was aborted because 
it was in e nererun mode Idue to NORERUN 
commend er macro). 

Condition onceuntered during terminal job 
recovery attempt. The JSN specified is 
net esseeieted with e job. 

Condition encountered during terminal job 
recovery attempt. 

Condition encountered during terminal job 
recovery attempt. 

The system wes unable to successfully rerun 
e job because of a mass steraga read arrer 
er because the OFT is full. 

The job must be of system origin type. 

A batch job was anterad from a card 
reader er routed from another mainframe 
with an ST peramater on tha job command, 
but tha job could net run on the 
specified remote aeinfreme. 

A batch job was antarad from a card 
raader er routed from another meinfreme 
with an ST perameter on the job command, 
but tha job could net run on the 
specified remote meinfreme because the 
specified user name was net validated to 
transfer queue files. 

The job has been successfully reprieved. 

The job has been terminated end requeued 
far input. 


None. 

None. 

None. 

None. 

None. 

None. 


ITF 

ITF 

ITF 

ITF 

ITF 

ITF 


None. ITF 

Resume activity or ITF 

else terminal will be 
diseennact ed■ 

None. ITF 


Chech the description of L072 
the L072 commend in 
section 9. 

Retry when current XAFEX 

operation is complete. 

Wait end retry later. CLASS 


None. Your job cannot FFM 

access the file. 

Correct the Job commend DSF 

end retry. 


Compare the Job command lAJ 
in error with the Job 
command description in 
soctien 7. Also ehach 
your validation limits. 

wait for the user prompt. HCLL07 


Inform site analyst. RECLAIM 

Correct the program to lAJ 

issue a correct recall 
request. 

Refer to the NORERUN lAJ 

command or macro 
deseription. 


Retry command. lAFEX 

Recneck the JSN. 


Retry command. lAFEX 


Retry commend. lAFEX 

Raeneck tne jsn. 

Resubmit the job to the lAJ 
system. 


»»one. CFMEM 

Contact site lAj 

personnel concerning 
your validations. 


Contact site lAJ 

personnel concerning 
your validations. 


None. 

lAJ 

None. 

1AJ 
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NeSSABE 


SICIilFlCANCE 


ACTIOW 


ftOUTIIIE 


JOB STEP ABQRT. 

JOB STEP LIMIT. 

JOB TEBMINATEO. 

JOBNAME !S jsn 

JSN MORE THAN POUR CHARACTERS. 

JSN NOT FOUND. 

JSN OR UJN MUST BE SPECIFIED. 

LABEL CONTENT ERROR, filaname AT «flldr«s$. 

LABEL MISSING, fMenama AT «ddr«ss. 

LABEL NOT EXPIRED. 

LABEL PARAMETER ERROR ON OPEN, filename 
AT address. 

LOO • ARGUMENT ERROR • addrass. 


Job step Aborted due to a system problem 
such as a rollout file uas corrupted due 
to a mass storage failure. 


The monitor detected the expiration of the 
job step SRU limit. 


The job had not yet completed login 
proeessino uhen you entered *DROP., ALL* 
from another terminal session. 


An LDI command queued a file for input. 

The entered job has the job sequence name 
jsn. 

you specified a job sequence name (JSN) 
of mere than four characters. 

For the JSN parameter of the CLASS command, 
you specified a JSN that is net in the 
system or that does net belong to you. 

The JSN or the UJN must be specified within 
the cennnand parameters. 


A blech read was the correct size for a 
label but one or mere required fields (such 
as the label name) were incorrect. 

During a read operation, a required label 
mas missing. 

You attempted to write on a tape with an 
unexpired label. 


Label fields did not match on the OPEN 
request. An additional message. 

FIELD BEGINNING AT addr NO COMPARE. 

specifying the decimal character position 
in HDR1 Of the first field that did not 
compare correctly, is also issued. 

One of the following conditions is true 
in the specified parameter blech address: 


Retry the job Step. 

If the problem 
recurs, inform site 
analyst. 

Reset job step limit 
with SETJ5L eeienand or 
macro and retry. If job 
step SRU limit is set at 
maximum, requast 
increased SRU velidatien. 

None. 


None. 


Correct the JSNsjsn 
parameter. 

Chech to see if you 
entered the correct JSN. 


Specify the JSN or the 
UJN and ratry the 
command. 

Use LISTLB command to 
obtain label data and 
r et r y. 

Ensure that tna tape 
has a label. 

If current contents 
of the tape can be 
sacrificed, have 
operator blanh label 
tape. otherwise, 
wait until label has 
expired. 

Use LISTLB command to 
obtain label data. 


Write a PSR and include 
support materials to 


1AJ 

lAJ 

lAFEX 

LDI 

DROP 

06ET 

CLASS 

06ET 

IMT 

IMT 

IMT 

IMT 

FOL 



xessAeg 


SICNIFICAMCE 


ACTIOM 


ROUTIWE 


I.1BED1T AKCUMEttT ERKORIS). 


LIBCEN ARGUMENT ERROR. 

LIBCEN FILE NAME CONFLICT. 

LIBRARY FILE NOT GENERATED. 
LIBRARY FILE NOT ON MASS STORAGE. 


LIBRARY GENERATION COMFLETE. 
LIBRARY GENERATION FILE EMPTY. 


LIBRARY NOT FOUND, Inane. 

LID • XXX DOES NOT EXIST IN THE LID 
TABLE. 

LIOSXXX OR STsxxx IS REOUIREO. 

LIO TABLE ENTRY. 

LINE LIMIT EXCEEDED. 


LINE NUMBER INCREMENT ERROR. 

LINE NUMBER LIMIT EXCEEDED. 

LINE NUMBER LIMIT EXCEEDED. 

LINE NUMBER OVERLAP ERROR. 

LINE RANGE ERROR. 

LINE TERMINATORS NOT USED ON A STRANGER 
TAPE . 

LINE Ifnnne TRUNCATED. 

LINE WAS DISCONNECTED WHILE LOANED. 

nnnnnnnnnnn LINECS) TRUNCATED. 

nnn LINES TRUNCATED. 

xxxxxx LINES TRUNCATED. 

nnnnn LINES TRUNCATED ON FILE fflenane. 

LIST OF FILES LENGTH TOO LONG OR ZERO. 


The LIBEDIT cefMnend contains an incorrect 
parameter. 


An incorrect parameter was used on the 
LIBCEN ceranand. 

Tha LIBCEN command nanad the same File as 
the input File and output File. 

The File to be processed did net contain 
any of tho proper record typos- 

An attompt was mado to gonorate a usor 
library onto a Filo not assignod to mass 
Storago. 

Message issued when the generation oF a 
library is eemplotod. 

Tho file to be processed is empty. 


Usor library Inane is not a local File. 

In a LISTLIO coflHMnd, you specified a LID 
that eithar does not exist or tnat the site 
had dafinod as not listable through LISTLIO. 

The LIO parameter or tho ST parameter was 
specified with no value. 

The system LIO table did net contain any 
ontries. 

Your job generated more lines of print than 
that for Which you are autherizod. IF you 
do not fill all pages, the system still 
assesses a minimum numbar of lines per paga. 


Lino number incronont specified is loss 
than one or greater than 4095. 


Tha 1ino number onceuntorod or required 
during a rosaquancing (RESEO) operation 
exceeded 99999. 

An attempt to move, duplicete. or reed a 
group of linos in tho odit file required a 
lino number greater than 99999 te b« 
assigned. 

Two or mere lino ranges have at least one 
lino number in common. 


An ineerroet lino number was specified in a 
line range. 

A lino terminator parameter was spoeiFiod 
♦or a file residing on a stranger tape. 


The indicated line of tho File was 
truncated during RESEO proeassing. 


TbB lino eonnoetion to your secondary 
application was broxon. 


nnnnnnnnnn lines wore truncated because 
they wore longer than ISO characters. 


Your File contained nnn lines which were 
140 characters or longer. Those linos 
wore trueatod by SECNOR. 

I or mere linos (xxxxxx) wore truncated 
when they were Found to bo longer than 
tho Fixed length lino length (FL 
parameter) on an FCOFV to a stranger 
tape. 

nnnnn linos on File filename nave been 
trunoatod. 


Tho list of files exceeds tho length of the 
lecel FNT. starts or extends beyond the 
job's Field length, or has a length of sero. 


ChoCK the LIBEDIT 
command description for 
the cerroet format and 
ret ry. 

Chock the fermet of the 
LIBCEN command and retry. 

Change tho input File or 
output File name. 

Cheek For proper source 
File. 

Cheese an output File 
that rasides on mass 
storage. 

Nona. 


verify that the File 
is local to job and 
contains data. 

Maka File Iname local. 

Chock to see thet you 
entered the correct LIO. 


Retry, specifying a 
value For LIO or ST. 

Contact site 
per senne 1 . 

Ensure thet your print 
Files do not contain 
undasirod lino foods and 
page ejects (refer to 
appendix H). if 
necessary, request a 
higher limit From your 
site. 

Reenter command with 
correct lino number 
ineremont. 

Examine program and 
cerraet line number in 
error. 

Rosoquonco tho Filo 
(using RESEO eeiMiand) 
and raantor tho command. 


Reenter eoweand with 
nen-ovarlapping 1 ino 
ranges. 

Roontor command with 
correct line renge. 

Remove tne lino 
tormineter peramotor and 
retry. 

Chock Filo to determine 
whether relevant data 
was lest. 

Enter another APPSW 
commend to reestablish 
the connection. 

Determine if relevant 
date was lest in the 
truncation. IF 
possible, split the 
long linos and ropoat 
tho copy oporatien. 

Nona. 


IF data lest was 
significant, retry 
command with a larger 
value For tho PL 
parameter. 

Inform site onalyst. IF 
many of those errors 
occur, the site analyst 
should perform a Full 
PPDUMP. total INITIALIZE, 
and Full PFLOAD on tho 
dovice. 

Contact CYBER 
Software Support. 


L 


LIBEDIT 

LIBCEN 

LIBCEN 

LIBGEN 

LIBCEN 

LIBGEN 

LIBCEN 

LIBRARY 

LISTLID 

LISTLIO 

LISTLIO 

OAP 

leoir 

RESEd 

IBDIT 

lEDIT 

lEDIT 

FCOPY 

RESEd 

TLX 

COPYC 

SECNOR 

PCOPy 

lEDIT 

lAU 


B*3S 




MESSACe 


SICIilFICAWCE 


ACTIPM 


ROUTIME 


LIST OPTION ERROR. 

LISTLB ABORT. 

LISTLB COMPLETE. 

LISTLID COMMAND ERROR. 

LITERAL STRING IS NOT ALLOWED FOR THIS 
PARAMETER. 

LOADER MISSING. 

LOCAL FILE XXXKXKX ALREADY EXISTS. 

LOCAL FILE LIMIT. 

LOCAL FILE LIMIT. 

LOG • PPU BUSY. 

LOST 7000 COMMUNICATIONS 
L072 COMPLETE. 

LRC ERROR. 


M.T. NOT 

aoorvss . 
MAGNETIC 


AVAILABLE ON FILE 

TAPE SUBSYSTEM NOT 


f i 1«n*ni« 

ACTIVE . 


AT 


MAINFRAMES 

MAINFRAME 10 NOT IN ID TABLE 

MAINFRAME UNAVAILABLE 

MARGINALLY WRITTEN TAPE. ff1«nAra« AT 

adorass. 


An ineorract list option ««s spoclflad for Changa tho aLO* 

turn «LOa paronotor In ttio LIBEOIT cofMiAnO. pAromatar to spaeify 

only valid options. 


A fatal arror oceurrad whila preeassing 
tna LISTLB eoMraand. 


Rafar to dayfila for 
causa of proPlam. 


Inferiaativa oassaga Indicating that tha Nona. 

LISTLB oparatlon has finishad. 


An Incerract argunant aas spaciflad. 
Saif-axplanatery. 

1AJ could net find BEGIN or LDRs. 

Tha flla could net Pa attaehad bacausa 
local file already exists with tha 
nama xxxxxxx. 


Correct and retry. 

Correct paranetar and 
retry. 

Contact your site 
support or CYBER 
Software Support. 

Use a different name 
In tha request or 
return tha local file. 


Tha job tried to create toe many local Reduce local file usage, 

fI las. 


Your ATTACH. GET, or OLD request cannot Return soma local 

Da processed, because you already have files and retry, 

tha maximum number of local files. 


OSD cannot assign a PP to process an 
entry at this time. 


Communleatlens between NOS and tha SCOPE 3 
system have been temporarily lost. 

Informative message Indicating that tha 
program has completed processing. 

The longitudinal redundancy cheek character 
was read incorrectly (8-track NR3I). The 
dayfila message STATUS ERROR, filename AT 
address precedes this message and specifies 
the file (filename) and the address. 

The magnetic tape executive Is net 
executing. 


Erase command and 
retry. Inform site 
analyst If the problem 
persists. 

Enter a RESUME directive 
to attempt recovery. 

None . 


Retry or inform site 
ana Iyst . 


Inform site operator. 
BrIng up MAGNET. 


One of the following occurred during a 
magnetic tape request: 

' There was no UDT address In the FST. 

• The UDT address in the FST was incorrect. 
The MAG subsystem was net present. 

Prompt requesting the LID of the SCOPE 3 
mainframe you want to access. 

The mainframe you requested is net 
avallable. 


The mainframe you specified Is net 
currently aveilable. 


Seme or all of the previous good blocks 
used to create the recovery block ID 
window cannot be read with error 
correction enabled during repesltionlng 
of the tape for write recovery. The tape 
Is marginal and will possibly fail on a 
Feed. The job will terminate to prevent 
the possibility of bad data in the 
1ibrary. 


Contact site operator 
to have MAGNET 
brought up. 

Otherwise, contact 
CYBER Software 
Support. 

Enter a valid SCOPE 2 
mainframe LID. 

Enter an alternate 
mainframe LID or type 
END to terminate the 
HELL07 session. 

Enter a 0UEUE7. ID 
command to list PlDs 
currently active. Then 
reenter the command with 
an active mainframe PID. 

Clean the tape drive. 

Have the tape cleaned and 
certified or use a new 
tape. 


MASS STORAGE DIRECTORY NOT WRITTEN. 

MASS STORAGE ERROR. 

MASS STORAGE ERROR. 

MASS STORAGE LIMIT. 


MAXIMUM FL ENCOUNTERED - JOB LIST 
INCOMPLETE. 


On a 6TR command, you have requested that a 
mass storage directory record be written on 
a nonmass storage file. 

An error was encountered in reading a 
portion of the permanent file catalog or 
permit Information (error log and dayfila 
Message). This Indicates a hardware 
problem with e dIsK pack or disk drive. 


Job wes tormlnatod without exit processing. 

You heve exceeded your mess storage 
validation limits. 


Tho systom has found too many roeevorablo 
Jobs. 


Ensure that file resides 
on mass storage. 


Inform site analyst. If 
many of these errors 
occur, the site aniayst 
Should perform a full 
PFDUMP. total INITIALIZE, 
and full PFLOAD on tna 
device. 

Resubmit Job. 

Return ell unneeded 
files end try age in. If 
the message occurs 
again, your validation 
limit is too low to 
allow She eperetien you 
era attempting. 

Proceed as normal or 
welt for ether Jobs to 
time out end try again. 
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LIBEDIT 

LISTLB 

LISTLB 

LXSTLID 

TRMDEF 

1 AJ 

OCET 

1AJ 

PFM 

OSD 

HELL07 

L072 

1MT 

IMS 

LFM 

RESEX 

HELL07 

NELL07 

0UEUE7 

1MT 

6TR 

PFM 

lAJ 

RECLAIM 

RECOVER 




MESSAGE 


SIGNIFICANCE 


ACTION 


ROUTINE 


MEMORY OVERFLOW. 

MESSAGE LIMIT. 

MFL LESS THAN EXTENDED MEMORY MINIMUM CM FL. 

MFL REOUEST TOO SMALL. MINIMUM USED. 

MFLINK « APPLICATION CONNECTION BROKEN. 

MFLINK • APPLICATION CONNECTION TIMEOUT. 

MFLINK > APPLICATION DISABLED. 

MFLINK • BLOCK TOO LARGE. 

MFLINK - CANNOT READ FROM fi1«nani«. 

MFLINK > CANNOT WRITE ON filpnams. 

MFLINK - CONNECTING TO lid. 

MFLINK - CONNECTION REJECTED BY REMOTE HOST. 

MFLINK • CONTINUATION BLOCK 0X0 NOT FOLLOW. 
MFLINK • ERR/LCL RECEIVED FROM SUBSYSTEM. 

MFLINK > FC/BRK RECEIVED RCtrc. 

MFLINK • FC/NAK RETRY LIMIT. 

MFLINK • FILE RETRANSMIT REOUESTED. 

MFLINK - INCORRECT LID. 

MFLINK • INVALID ACCESS VALIDATION. 

MFLINK • INVALID COI«ilAND cmd. 

MFLINK • INVALID CONTROL STATEMENT. 

MFLINK - INVALID DATA DECLARATION. 

MFLINK • INVALID DIRECTIVE FILE NAME. 

MFLINK - INVALID FILE NAME. 

MFLINK • INVALID FILE TYPE. 

MFLINK • INVALID SUPERVISORY MESSAGE. 

MFLINK • LID CURRENTLY UNAVAILABLE. 


InsuFfieiant Fi« 1 d langth has baan 
spaeifiad far KRONREF te axaeuta. 


Tha nuBibar of massaga's issuad by tha job 
has axaaadad tha limit for which you ara 
authorized. Massaga functions issued by 
eerapilars or applications that run in the 
job's field length ara also counted as job 
dayfiia massages and thus ara subject to 
your dayfila massage limit. 

To use axtondad memory, you must have a 
required minimum amount of central memory 
field length. This message indicates that 
you do not have the required central memory 
field length. 

MFL request was lass than CONTROL'S RFLs 
value. CONTROL’S RFL* value is used for 
this MFL request, thus allowing further MFL 
requests. 

The connection with tho romete host was 
broken by the network or remote host . 


The remote host did net respond in the 
allotted time. 


The operator has disabled FTF for the 
network subsystem {RHF or NAM}. 


The remote host or the network sent a block 
or mossege that was too larga. 

The file filename dees net have reed 
permission. The file type is net 
supported by MFLINK or the file 
dees net exist. 

The file filename dees net have write 
permission or tho file typo is net 
supported by MFLINK. 

Infermetivo mossege. You ere being 
eenneeted te tho romete host you specified. 

The remote host you specified has rejected 
the connect ion. 

The eentinuatien block did net fellow. 

The network subsystem fRHF or NAM) detoetad 
a logic error in cemmunieation. 

The remote host has sent a break with 
reason cede re. 

MFLINK was unable te transmit a block after 
« systom*definad number of attempts. Each 
attempt was rajoetad by the network 
subsystem IRHF or NAM). 

The remote host has requested that the host 
retransmit tha file. 

Mo mainframe in the network has the 
specified logical identifier (LID), or the 
LID specified contains an illegal eherecter 
or is net throe ehereetors long. 

Your user nemo dees net have the required 
validation te access tho romete rneinfrdme. 


The system received an invalid eenmend 
(emd) from the remote host or received e 
eeiwpend out of sequence. 

You specified an incorrect parameter or 
value on tho MFLINK command. 

You spocifiad an incorrect 0D>dd parameter 
on the MFLINK commend. 

You specified an ineerraet ladirfiia 
parametar on tho MFLINK command. 

The file name you specified on tho MFLINK 
commend is incorrect. 

The file you attempted to transfer te a 
ramoto host does not have a local file type. 


The remote host or tho network sent an 
incorrect or unsupported supervisory 

message. 

Tho network subsystem (RHF or NAM) is 
unable to eemploto tho cennaetion te 
tho remote host. 


Increase field length KRONREF 

with RFL command and 
retry. 

Split job into two or lAJ 

mere jobs and retry. 


Increase central memory IMA 
field length. 


Check the description of CONTROL 
field length control in 
sect ion 3. 


Inform site analyst. MFLINK 

MFLINK retries unless 
unless EF specified. 

Inform site analyst. MFLINK 

MFLINK retries unless 
EF specified. 

Contact site operator. MFLINK 

MFLINK retries unless 
RT specified. 

Inform site analyst. MFLINK 


Correct end resulMit. MFLINK 


Correct end resubmit. MFLINK 


None. MFLINK 


Inform romete analyst. MFLINK 


Inform site analyst. MFLINK 

Inform site analyst. MFLINK 


Inform site analyst. MFLINK 


Inform site analyst. MFLINK 


None. MFLINK 


Usa tho LISTlXO command MFLINK 
te select the proper LID. 


Contact your site MFLINK 

adminiStrat or to got 
tho autherisation. 

inform sit# analyst. MFLINK 


Correct tha MFLINK MFLINK 

command and ratry. 

Correct tha MFLINK MFLINK 

command and ratry. 

Correct tha MFLINK MFLINK 

command and ratry. 

Correct tha MFLINK MFLINK 

command and ratry. 

Ensure that tha file has MFLINK 
the eorraet type and 
ratry. 

Inform site analyst. MFLINK 


Contact site operator. MFLINK 

MFLINK retries unless 
RT specif lad. 


L 
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MCSSACE 


SICNIFICAHCE 


ACTION 


ROUTINE 


MFLINK 

MFLINK 

MFLINK 

MFLINK 

MFLINK 

MFLINK 

MFLINK 

MFLINK 


MFLINK • 
MFLINK > 

MFLINK • 

MFLINK • 

MFLINK • 

MFLINK • 

MFLINK • 

MFLINK • 

MFLINK • 

MFLINK > 


- LIO OISAOLEO. 

• LID NO LONGER AVAILABLE. 

‘ LIO UNKNOWN TO SUBSYSTEM. 

- LOCAL NETWORK RESOURCE LIMIT. 

> NETON REJECT : rc. 

• NETWORK SEOUENCE ERROR. 

• NETWORK SHUTDOWN. 

NETXFR ERROR rc - rAjn«5S 


NETXFR STATUS * O. 

NO CONNECTION RECEIVED. 

NO LID SFECIFIEO. 

NO FATHS AVAILABLE TO LIO. 

NO REMOTE DIRECTIVES FOUND. 
FROTDCOL ERROR IN xx. 

RECOVERING ST 1«d. 

REMOTE SUBSYSTEM NOT RESFONOING. 

REMOTE SUBSYSTEM RESOURCE LIMIT. 

SUBSYSTEM FULL. 


The wainfrarao with th« spNcifiod legicAl 
idwntifior (LID) has baan dfsablod by tha 
systsm. 

Tha status of tha LID has ehangad. Tha lid 
is no lengar dafinad. 


Tha natwerk subsystam (RNF or NAM) has 
rajaetad a eonnaetion roRuast to tha 
spaeifiad LIO avan though tha systam LID 
tabla indieatas a natwerk path is 
availabia. 

Tha natwerk subsystam [RHF or NAM) is 
tanperarily unable to eemplata tha cen- 
naetien to tha raquastad raneta host. 


A systam or natwerk error eeeurred. 
re Reason coda 

A network massage block was found for tha 
eonnaetion before the connection was 
completed. 

The operator has disabled tha RTF 
application in tha network subsystam (RHF 
or NAM). MFLINK terminates tha natwerk 
connection. 


An error occurred during file transfer. 

rc Reason cede 

rajraass Reject message 

•■c rajmass 

03 CONNECTION BROKEN. 

04 PROTOCOL ERROR. 

05 TIMEOUT EXPIRED. 

OS BLOCK NOT SENT. 

OT TOO MANY TRANSFERS. 

OB ACN DUT>0F*RAN6E. 

09 CIO ERROR. 

13 IDLEOOWN ERROR. 

14 SHUTDOWN. 

15 RHF I/O ERROR; 

IB INCORRECT DEVICE. 

IT CODE CONV N/A. (not avail) 

IB CONTROL WORD ERROR. 

19 INCORRECT OEVICE. 

20 EMPTY FILE. 

21 NAM INTERFACE ERR. 

22 BLK NUM MISCQMPARE. 

23 INCORRECT BLK SIZE. 

2S BLOCK SEOUENCE ERR. 

2B PRU BOUNDS ERROR. 

2T INTRA'HOST PRU XFR. 

2B ERROR DURING XFR. 

29 ABL OUT OF RANGE. 

30 APPL NOT VALIDATED. 

31 FILE TYPE ERROR. 

32 JOB ORIGIN ERROR. 


A system or network error occurred. 

The natwerk failed to respond to tha 
application connection raouest bofora tha 
timeout period elapsed. 

You failed to specify the STdid parameter 
on tha first MFLINK eonmiand of tha MFLINK 
session. 


Contact site operator. MFLINK 

MFLINK retries unless 
RT specified. 

Contact site operator to MFLINK 
define tha LIO and try 
again. MFLINK retries 
unless RT specified. 

If the problem MFLINK 

persists, inform site 
analyst. 


If tha problem MFLINK 

persists, inform site 

analyst. MFLINK 

retries unless RT 

specified. 

Inform site analyst if MFLINK 

problem persists. 


Inform site analyst. MFLINK 


Contact site operator. MFLINK 


Inform site analyst if MFLINK 

problem persists. 

MFLINK retries unless 
EP specified. 


Inform site 

analyst. 

MFLINK 

Inform site enalyst if 
problem persists. 

MFLINK 

Correct the 
command and 

MFLINK 
retry. 

MFLINK 


No paths are currently available to any 
remote host with the specified LID through 
either network subsystem (RHF or NAM). 


If message persists. MFLINK 

contact sita oparator. 

MFLINK ratries if RT 
not spoeifiad. 


The system is unable to find 
diroctivos. 


MFLINK roceived 
paramoter xx. 


an ineorraet 


your MFLINK 

value for the 

system is 
mainframe 


An inferaMtive message. The 
recovering the files for the 
specified by 1 id. 


The network subsystem (RHF or NAM) cannot 
establish communication with the ramote 
host. 


The network subsystem (RHF er nam) on the 
remote host is temporarily unabla to 
eemplata tha oennaetien. 

The network subsystom (RHF or NAM) is 
tomperarily toe busy to process your 
request. 


Correct the MFLINK 
commend and retry. 


Inform site analyst if 
problems result. 


MFLINK 

MFLINK 


None. 


MFLINK 


Contact sita operator. MFLINK 

MFLINK retries unless 
RT is specified. 

Retry. If massage MFLINK 

persists, contact 
sita operator. 

Contact sita MFLINK 

operator. MFLINK 
rotrios unless RT is 
specified. 
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MESSAGE 


SICWIFICAWCE 


ACTION 


SOUTINE 


MPLINK ' SUBSYSTEM UNAVAILABLE. 

MFLINK - UNKNOWN NETWORK INTERFACE TYPE. 

MFLINK - WRONG REMOTE APPLICATION LEVEL. 
MFLINK • TRANSFER IMPOSSIBLE TO ST lid. 


MFOUEUE • COMPLETE, 
jsn s ROUTED FILE NAME. 

MFOUEUE • CONTROL STATEMENT ERROR. 


MF9UEUE - DIRECTIVE EXCEEDS 2S8 CHARACTERS 
MFOUEUE - DUPLICATE PARAMETER. 

MFOUEUE - FIRST PARAMETER NOT VALID LPN. 


MFOUEUE > 

ILLEGAL 

DC 

VALUE 

SPECIFIED 

MFOUEUE > 

ILLEGAL 

00 

VALUE 

SPECIFIED 

MFOUEUE - 

ILLEGAL 

ST 

VALUE 

SPECIFIED 


MFOUEUE - INVALID DIRECTIVE NAME. 
MFOUEUE > INVALID PARAMETER. 

MFOUEUE ‘ NO REMOTE DIRECTIVES FDUND. 


MFOUEUE - ST FARAMETER MUST BE SPECIFIED. 
MFSTAT REJECTED REOUEST 


MISSING DEMAND FILE ENTRY. 


jsn MISSING RESOURCE. 


MISSING VSN OR 


EOUIPMENT ASSIGNMENT. 


MODE ERROR. 

MONITOR CALL ERROR, xxxx nnnnnnnnn. 


MTost, ASSIGNED TO fi1onani«, VSN*vsn. 


MT.Cee, Eoe. HHhiihhhhh, BCR. 


Tho network subsystom is temporarily toe 
Dusy to process your request. 


An internal error was detected by MFLINK. 

You entered an MFLINK ceromand witn STiiid; 
the transfer failed because MFLINK's 
protocol version or level is incompatible 
with the Permanent File Transfer Facility 
(PTF) software at the remote host. 

Job jsn was successfully routed. 


MFOUEUE was unable to process the command. 
Usually an invalid character or successive 
separators is the cause of this problem. 

The user supplied remote directive for this 
command exceeds 2S6 characters. 

Multiple occurrences are net allowed for 
any of the MFOUEUE parameters. 

The first parameter must be a valid file 
name. 

Tne OCsde parameter is not supported. 

Your ODsdd specification is net supported. 

The logical identifier (LID) you specified 
in the STslid parameter is not three 
alphanumeric characters. 

The directive file name must be a valid 
file name. 

You specified a parameter that is net 
allowed on the MFOUEUE command. 

The directive file was empty or you did not 
supply remote directives vie the PC 

paremet er . 


The ST perameter is not optiena 
appear on each MFOUEUE command. 

You did net enter the correct P 
SCOPE 2 mainframe. 


1 . It 

must 

ID for 

the 


Dayfile message indiceting a system problem. 
The overcommitment algorithm was initiatad 
without a demand file entry having been 
oaf{ned previeus1y. 


Dayfile message indicating that a system 
problem occurred. The system axpoetod but 
did not find a roseurea unit assigned to 
tno job with job soquonea name jsn. This 
could occur if the MAC subsystem was 
stepped while tapes were assigned. 


Dayfile massage indicating a system 
malfunction (expected VSN or aguipmont 
assignment was net found). 


An arithmetic error er CPU/CM parity error 
has baan eneeuntarad during processing of 
Job. 

One of the following occurred during the 
processing of e monitor request: 

• The monitor request call was not 
recegnitod by the system. 

Bad paramatars ware supplied in the 
request. 

• An incorrect user access was encountered. 
- An incorrect request was included in the 

request. 

The specified file name is assigned to the 
tape volume with the specified VSN that is 
mounted on tape drive TTest (tne 
spvop'track (MT) or a nina-traek (NT) tape 
unit with EST ordinal ast ) . 

Magnetic tape controller centrelwere 
resterteo. BCR identifies B.C. RESTART. 


Contact sita 
operator. MFLINK 
retries unless RT is 
specified. 

MFLINK 

Inform site analyst. 

MFLINK 

Inform site analyst. 

MFLINK 

None. 

MFOUEUE 

Correct the commend. 

MFOUEUE 

Correct the directive. 

MFOUEUE 

Correct the commend. 

MFOUEUE 

Correct the commend. 

MFOUEUE 

Correct the commend. 

MFOUEUE 

Correct the commend. 

MFOUEUE 

Correct the commend. 

MFOUEUE 

Correct the commend. 

MFOUEUE 

Correct the commend. 

MFOUEUE 

Fix the job so that the 
directive file is net 
ompt y. 

MFOUEUE 

Correct the command. 

MFOUEUE 

Bo sura to use only the 
primary physical 
idontifiar (PID) to 
rafaronea a SCOPE 2 
mainframe. You My 
enter e OUEUET, ID 
commend te list PIOs 
currently active. 

OUEUE7 

Rerun the job. If the 
problem reoccurs, inform 
e site analyst, write 
e PSR end Include 
support Mteriel so that 
CDC can duplicate the 
preblom. 

RESeX 

Rerun the job. If the 
preblomi raoeeurs. inform 
a site analyst, write 
a PSR and include 
support materiel so that 
CDC can duplicate the 
problem. 

RESEX 

Reenter the command er 
rerun the job. If the 
preblom reoccurs, inform 
your site analyst or 
contact CYBER Software 
Support. 

RESEX 

Examine reprieve block 
error flag te determine 
the nature of the error. 

1 AJ 

Examine program te 
determine why an 
incorrect monitor 
request call is being 
made. 

lAJ 


Inferaetive message. RESEX 

Processing of the tape 
file can begin. 


None. 


IMT 


totsitso L 
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MESSagE 


SICMIFICAWCE 


flCTION 


EOUTIWE 


MT . Cee , e*c. Hhhhhirhhh. IFR . 

MT.Cee.Eec.Hhhhhhhhh,8PW. 

MT , Cee , Eee.Hhtirihftiihh.BTL . 

MT .Cee.Eec.Hhhhhhhhh. luST. 

MT.Cee.Eee,Hhhhhhhhh,CMF. 

MT.Cee,Cee.Hhhhhhhhh. CON. REJ. OFF. 


RRFer to the REAP ID BURST FAILURE 
taesseoe. 

Refer to the WRITE ID BURST FAILURE 
nesseoe. 

Refer to the BLOCK TOO LARGE nessege. 

Unft wes Stf 11 busy efter one second. 

Refer to the CHANNEL MALFUNCTION atessege. 

Connect reject; unebie to connect to unit. 
Unit turned off. 


Inform customer engineer. 1MT 

Inform site enelyst. IMT 


MT .Ccc.Eec. Hhhhhhhhh .ERA. 

MT .Ccc.Eee. Hhhhhhhhh . FNff f f,Fyyyy. 

MT ,Cec.Eee. Hhhhhhhhh . Lbbbb, Bnnnnnn. 


MT.Cee,Eec.Hhhhhhhhh. LCH. 

MT.Cec.Eec.Hhhhhhhhh. MOW. 


MT.Cee.Cee.Hhhhhhhhh. MOF. 


MT.Cec.Cec.Hhhhhhhhh. MWT. 
MT.Cee,Eec,Hhhhhhhhh, NBC. 


Refer to the ERASE LIMIT messege. 


Funetion ffff wes rejected by the Inform site enelyst. IMT 

contreller; yyyy is the eddress in IMT 
where the function wes initiated. 

The length (bbbb) end blocK number (nnnnnn) None. IMT 

reed from trailer bytes in bleek did not 
meteh the aetual length or the block number 
reed given in previous messego line. 

Lead sequence failed on the unit. LCH Push CLEAR button and IMT 

identifies LOAD CHECK. reload tape, or inform 

site analyst. 

Indicates controller failure. Channel Inform eustomer engineer. IMT 

has been logically turned off and 
maintenance is required. MOW identifies 
MARGINAL. DOWN. 

Unit has been logically turned off Inform eustomer engineer. IMT 


because of read/write failure. This 
oeeurred when a special function to check 
the read/write path to a unit failed 
during initial label scan. Maintenance 
is required. MOF identifies MARGINAL. 

OFF. 

Refer to the MARGINALLY WRITTEN TAPE 
message. 

A noise block was skipped on the tape. None. IMT 

NBE identifies NOISE. 


MT.Ccc.Eee.Hhhhhhhhh, NO COP. 


No end'of'Operation detected from unit Inform customer engineer. IMT 

within 1 second. 


MT.Cee.Eec.Hhhhhhhhh. NOT ready. 
MT,Cee.Eec.Hhhhhhhhh. OPA. 

MT.Cec.Eee.Hhhhhhhhh. DTP. 

MT.Cee.Eee.Hhhhhhhhh. plo. 


Tape unit dropped ready status. Make unit ready. IMT 

Refer to the WRONG PARITY message. 

Error was corrected as the data was read. None. IMT 

OTF identifies ON THE FLY. 





MESSAGE 


SIGNlFieAMCE 


ACTIOW 


AOUTIIIE 


MT.Ceeo^'uu^vsn^rw.sst.Ss. CSgggggggg. 

MT , Ccc .Oddcl. . .d . 

MT.Cee,Uuu...u« Ttttt. 

HT«Cec,Pfr.l{i.Bnnnnnn,LbbOb. Pppppppgp. 
MT . Cee . E«e .Hhhhhr«hhh. t ype . 


rw ftead CRD] or wrfts (WR) 

eperdtion; any operation not 
involving an aetual road or 
write is listed as a read. 

•St EST ordinal of the unit on 

wbien the tape wes last 
iaboled. This is provided 
only for labeled tapes 
generated under NOS; 
otherwise, the field is 
blank. This field dees net 
represent the EST ordinal 
of the tape unit that the 
tape is currently neuntod on. 

s Channel status. 

00000099 General status of magnetic 

tape unit. Last byte is 
block 10. Refer to the tape 
drive's hardware reference 
manual for general status 
infermation. 

The MT.Cec,Dddd...d line of the raessago 
provides the following information. 

ec Channel number; the channel 

number is repeated to allow 
tne analyst to associate 
this message with the first 
message if errors are 
occurring on mere than one 
tape Channel at the same 
t ime. 

ddd...d Detailod status of magnetic 

tape unit. Refer to the tape 
drive's hardware reference 
manual for general status 
informat ion. 

The MT.Ccc.Uuu...u,Ttttt line of the 
"•ss*0« provides the following information. 

•• Channel number; repeated to 

associate this message with 
the previous message, 
uu. . .u Datailed unit status. 

Refer to the tape 
drive's hardware reference 
manual for general status 
infermation. 

Tttt Third byte of the tape unit 

format parameters (refer to 
the Magnetic Tape Subsystem 
Reference Manual for 
descriptions of unit format 
parameter fields). 

The MT.Ccc.Aaaaaeaaa line (for FSC only) 
contains the additional sense byte 
status not pieced in the detailed status 
or unit status fields. 

ec Channel number, 

aaaeaaaa Sense byte. 

The MT.Cec.Pff.Rpppppppp line of the 

message provides the following information. 
cc Channel number; repeated to 





MESSACg 


SICMIFICAWCE 


ACTIPH 


ROUTIWE 


MULri'FlLE NOT FOUND. fn«nam« AT Nddrvss. 


MULTI-TRACK FHASE ERROR. 


MULTIPLE CONCURRENT LOGINS PROHIOITEO. 


MULTIPLE 7000 JOES DISALLOWED 


NETWORK APPLICATION ABORTED. RC « 6A. 
NFETCH: ILLEGAL FIELD MNEMONIC. 

NETWORK APPLICATION ABORTED, RC > 69. 
NSTORE: ILLEGAL FIELD MNEMONIC. 

NETWORK TYPE DOES NOT SUPPORT ATTRIBUTE 
COMMAND . 


NEXT VSN, «St. vsn. 


NO ALTERNATE STORAGE COPY OF FILE. 


NO CLOSING DELIMITER FOUND. 


NO DATA FOUND FOR USER NAME. 


Efthor LISTLB has roachad tha and of tha 
multiffla sat or tha raquastad fi)a was net 
Found. Tha following additional massagas 
ara also givan. 


REQUESTED SECTION XNXX. 
FOUND SECTION yyyy. or 
FILE IDENTIFIER NOT FOUND. 


Tha filanama. addrass. xxxx. and yyyy givan 
can ba ignorad. 


Multipla tracks ware found to ba in arror 
at 1600 epi . BMtking racovary impessibla. 
Tha dayfila massaga STATUS ERROR, filanama 
AT addrass praeadas this massaga and 
spaeifias tha fila ffilanama) and tha 
address- 

Another terminal session is active under 
your user name and you ara net validated 
to have mere than one terminal session 
SimuItanaeus1y. 

You have attempted to submit a second job 
file Whan you already have an outstanding 
SCOPE 2 job in processing. 

Either tha field or value parameter in the 
indicated call was net found. 

Either tha field or value parameter in the 
indicated call was net found. 

You are attempting to enter NAM/COCNET 
commands from a NAM/CCP connection. 


Tape volume vsn is mounted on tape unit est 
and accepted as the next volume in the file 
being processed. 

The disk space for the file cannot ba 
■‘eleasad because the alternate storage 
image is labeled obsolete or the alternate 
storage address is net specified in tha 
permanent file catalog. 

No closing delimiter was found on a 
string. A string is considered to end 
after the last nenblank character. 

RECLAIM could net find the calling user in 
tha directory of the database. 


If LISTLB reached the 
end of the multifile 
set. the operation is 
complete and no action 
is required. Otherwise, 
ensure that tha correct 
tape is being used and 
that it contains the 
desired files. All 
label parameters must 
match in order to 
position to tha 
specified file. 

Retry or inform site 
analyst. 


If you need to do this, 
contact your site 
personnel. 


Wait for tha first job 
to complete before 
submitting another job. 

Correct tha call and 
rerun tha job. 

Correct the call and 
rerun tha job. 

Ensure that tha 
attributes you ara 
trying to change can ba 
Changed in your network 
by TRMOEF. 

None. 


None . 


None. 


Cheek for correct 
database file 


1MT 


1MT 

NVF 

MELL07 

FIP 

FIP 

TRMOEF 

1MT 

PFM 

lEOlT 

RECLAIM 



MESSAGE 

NO HOST SELECTCD CONTROL CHARACTER»eh«r 
ENTER ch«r HN*NODE NUMBER or 
HSsNAME TO SELECT HOST 

NO JOE CHARACTERISTICS SPECIFIED. 

NO JOBS FOUND. 

NO JSN'S RECOVERED. 

NO LIDS FOUND. 

NO LINE NUMBER ON LINE. 

NO LINE NUMBER ON SORT FILE. 

NO LINE TERMINATOR AT EOR{S). 

NO LINES FOUND. 

NO MASS STORAGE AVAILABLE. 

NO NEW FILE. 

NO PERMITS. 

NO PRIMARY FILE. 

NO PRIMARY PILE. 

NO READ/OESTINATION FILE SPECIFIED. 


SIGNIFICANCE 

ACTION 

ROUTINE 

You havo net seleetecf m host and • host ks 
Availadle. 

Select a host. 

CCP 

char The network control 

character for your terninal 



You sReetfiad no parameters or loade 
tnconplete parameter specifications on the 
SETJOB command. 

Do not enter the command 
if you do not want to 
change any job 
characteristics. 

Dtherwiso, specify the 
parameter correctly. 

CONTROL 

The system can find none of yeur jobs. 

None. 

ENOUIRE 

The system anceuntered an COR. EOF, or EOI 
while reading input directives. 

None. 

RECOVER 

Cither the LID specified was net listable. 
or there were no listable LlDs found for 
a given PID. 

Cheek to see that 
you have spacified 
the correct LIO 
and/or PIO. 

LISTLIO 

Either the primary file or a seguenced 

READ file contains a line without a line 
number. 

Use an editor to 
correct the bad 
line. 

lEDIT 

A line on the input file to a SORT request 
is missing a lino number or a line exceeded 
the line length limit. 

Check the format of the 
input file. 

SORT 

You attempted to copy a file in which the 
last line of one or more records did not 
have a line terminator. 

Check the structure of 
the file to be copied. 

COPYC 

No line in the edit file meets the criteria 
specified by the edit command. 

None. 

lEDIT 

No mass storage space of the requested 
type could be found. 

Retry later. 

LPM 

NsO was inappreprlately specified for the 
*N« parameter. 

Either omit the vN* 
parameter to allow the 
default file «NEW« to be 
used or set it equal to 
the valid file name. 

LIBEOIT 

No permit entries exist for the specified 
f i 1e. 

None. 

CATLIST 

The command entered requires a primary file. 

Establish a primary file 
with NEW. OLD, or 

PRIMARY command and 
reenter original eenmiand. 

lAFEX 

A ceoMMind needed the primary file as the 
default file. No primary file was found. 

Specify a file name on 
the command or create a 
primary file with the 

NEW, OLD, or PRIMARY 
command, end then retry. 

PFILES 

No read or destination file was specified 

Reenter command with a 

lEDIT 




MESSACt 


SIGNIFICANCE 


ACTION 


NOUTINE 


NO VALID DUMP FOUND ON DUMP FILE. 


NO WAITE ENABLE, f llAn4inia AT addrass. 


NO 7000 JOB ACTIVE 


NOISE BLOCK PAOCESSINC 


IN EFFECT. 


ftnnnnnnnnnnnnnn NOISE 
nnnnnnnnnnnnnnn NOISE 


BLOCKS 

BLOCKS 


DELETED. 
FAOOEO. 


NOISE SIZE IGNORED FOR FE/CE. 


N0N-8UFFERED EC'S CHECKFOINTEO. 
RECOVERY ABORTED. 


NON-EXISTENT EDIT VERB SPECIFIED. 


NON-MATCHING CONVERSION. 


For a COPY. LOAD, or LIST oporatien. 
RECLAIM datorminod that tha fila was not a 
RECLAIM dump flla; tha diraetiva that 
oausad this aassaga is ignorad. 


Eithar you attomptad to wrtta on a tapa 
mountad with no writa ring or no writa 
was allowad Oaeausa of additional 
constraints dascripad in an additional 
fBossaga lino. 


YOU issuad a STATUS or RESUME diractiva 
whan no SCOPE 2 Job can ba assoeiatad with 
your usar none. 

Noisa proeassing was automatically salactad 
bocausa tno output tapa noisa sisa axcaadad 
tha input tapa noisa sisa on a COPY whara 
no noisa sisa was spacifiad. 

Blocks smaller than noisa sisa on S or L 
output tapa hava boon dalatad/paddad. 

An inPormativa massaga indicating that you 
ontarad a LABEL. REOUEST. or ASSIGN command 
with a noisa siaa (ns paramatar) spacifiad 
for a PE or GE density tapa on an ISMT 
subsystem. The NS paramatar is ignorad for 
those tapa dansitias on an ISMT subsystem. 

In tha recovery process of aborting a CM 
raeovary, ICK was called to process 
outstanding ehaekpolnt requests for all 
nonbuf forad davleas. 

Int arna1 error. 


Informative massaga indicating conversion 
ffloda on labeled B-track tapa differs from 
TNat spacifiad by assignment request. 
System writes tapa in spacifiad mode or 
Foads tapa with writa ring out in correct 
mode. Howavar, reading tapa with writa 
ring in or using wrong conversion mode 
goneratas conversion errors. 

Informative massaga indicating that tha 
density specified on the command or macro 


Nona. 


If no additional message 
line appears, ensure tha 
inserting of a writa 
ring by specifying tha W 
proeassing option on tha 
tapa raciuest (for 
axampla. POaw on the 
LABEL conmand). 
Otherwise, refer to the 
description of tha 
massaga in tha 
additional message line. 

Nona. 


Nona. 


Nona. 


Nona. 


Laval o deadstart is 
rORu i rad. 


Submit a PSR with 
information on how 
to duplicata tha 
problem. 

If reading tape with 
writa ring in, raturn 
and reassign with 
correct conversion mode. 


RECLAIM 

1MT 

HELL07 

COPYB 

COPVB 

RESEX 

ICK 

lEDlT 

RESEX 


NON-MATCHING DENSITY. 


Nona. 


RESEX 





M65SACE 


SICNiriCAHCE 


ACTION 


NOUTIME 


ujn NOT FOUND. 

Jsn NOT FOUND. 

Ujn NOT FOUND. 

XKX NOT IN PP LIB. 

XXX NOT IN PP LIB. CALLED BY yyy. 

NOT MULTI'MAINFRAME ENVIRONMENT 

filename NOT ON MASS STORAGE. 

filename NOT ON MASS STORAGE. 

jsn NOT RECOVERABLE - SECURITY CONFLICT. 

NOT VALID TO DOWNGRADE DATA. 

NOT VALIDATED FOR REOUESTEO ACCESS LEVEL. 

NOT VALIDATED FOR WRITING UNLABELEO TAPES. 

NOT VALIDATED TO SET XD/XT. 


The system could not find a file with the Check to see if the 

specified user job name (ujn). file is still in the 

queue. 


The system could not find the job with 
the specified JSN. 


Check to see if you 
specified the correct 
JSN . 


The system could not find the job with 
the specified UJN. 


Cheek to see of you 
specified the correct 

UJN . 


Oeyfile messaoe indicating that PP package Ensure that the correct 

XXX was not found in PP libraries. PP package name was 

specified. 


Oayf ile message indicating that PP package 
XXX, Which was called by package yyy, was 
net found in the PP libraries. 


Ensure that the correct 
PP package name was 
Specified or write a P5R. 


The user called OUEUE7 in a non* 
mu Iti-mainframe environment. 


The file to be saved is not on mass 
storage: the first track of the file is not 
recognixable. 

filename was not processed because it could 
not be found on mass storage. 


The specified job had a higher access 
level limit than the current job, and 
therefore could net be recovered by the 
current job. 

You attempted to lower the access level of 
a permanent file, but you are net validated 
to downgrade files. 


User has specified an access level outside 
the user's access level validation. 


User has not been validated for writing on 
unlabeled tapes. 


You specified an XD or XT parameter in a 
CHANCE. DEFINE er'PERMIT command or macro 
without having validation to use those 
parameters. 

RPAd error oausod loss of words in the 
dayfile. 


None, 0UEUE7 cannot 
be used in e 
non-multimeinframo 
onvirenroent. 

Verify that file is on 
mass storage. 


Move file to mass 
storage or correct the 
command end retry. 

None. 


Contact your site 
seeur ity 

administrator if you 
nood to be able to 
downgrade data. 

Uso a validated access 
level er site must 
validate user for 
additional access level. 

Either uso e labeled 
tape er site must 
velidato user for 
SAVsCULT M0DVAL 
priVilege. 

Retry without XO er XT 
paramotar, er obtain 
validation and retry. 


None. 


OGET 

DROP 

DROP 

SFP 

SFP 

OUEUE7 

PFM 

MFILES 

RECOVER 

PFM 

RESEX 

RESEX 

PFM 


NOTICE*** DATA READ ERROR. 


OAYFILE 



MgSSACE 


SICNIFICAWCE 


ACT low 


ROOT I WE 


0N5W, X rnOM OPERATDIl 

OP OPTION NOT VALID. 

OPERATOR DROP. 

OPERATOR DROP. 

OPERATOR INPUT TERMINATION. 
OPERATOR KILL. 

OPERATOR OVERRIDE. 

OPERATOR RERUN. 

OUTPUT INCOMPLETE 

OVERLAPPING INSERT OR DELETE. 

OVERLAY FILE EMPTY. 

OVERLAY FILE NOT FOUND. 

OVERLAY LOST. 

OVERLAY NOT FOUND. 

OVERLAY NOT FOUND IN LISRARY 


ov 1 nanitt. 


An ONSW comiMind was 4 ssuad to tli« jots by 
tho censolo eporater. x raprosants tho 
sons* switchas that nova boon turnod on. 


You spocifiad soaa valua othar than T for 
tha OPsep paramatar. 


Infornativa massaga indicating that tha 
oparater dreppad tha job. 

Tha systan oparator dreppad RECLAIM. 


Job was tarainatad without axit proeassing. 

Tha oparator antorad a KILL command to 
drop tha job. This disallows axit 
proeassing uniass tha job has axtandad 
rapriava. A job with axtandad rapriava 
proeassing is rapriavad onea. Exit 
proeassing is a 1 lowed. 


Tha oparator antarad an OVERRIDE command to 
drop tha job. This disallows axit. araxit, 
and rapriava proeassing. 


Tha systam 
A hardwara 


oparator rastartad tho job. 
or software problem occurrad. 


LIBEOIT aneountarad an overlap in tha 
record names specified in tha directives. 


No data appears in the raquastad file. 

The specified file was net available. 

The specified overlay was net found. 

Tha specified overlay was not found. 

Tha overlay ovinama was net found in tha 
systam library. 


Nona. 


IRI 


EYthar emit tha OPsop RECOVER 

paramatar or specify T 
for its valua. 

Nona. 1AJ 

Inform site analyst. RECLAIM 

Resubmit job. lAJ 

Correct job as needed RECLAIM 

and rerun. lAJ 


Correct job as needed lAJ 

and rerun. 


None. RECLAIM 

Reenter tha command. If OUEUET 
tha same massage is 
roturnad. inform tha 
Site ana lyst. 

Correct tha directives LIBEOIT 

listed in the LIBEOIT 

output so that there is 

no overlapping of file 

names for insert ions or 

da 1 ations. 


Verify that tha lAJ 

overlay file is 
va 1 id. 

Verify that file is lAJ 

local to job and rotry. 

Contact your site lAJ 

support or CYBER 
Softwara Support• 

Verify that tha file lAj 

with tha specified 
overlay is local to tha 
job. 

Verify that the call lAJ 

is to a valid 



WESSACE 


sigNirrcAwcE 


ACTIOW 


HOUTIME 


PARITY ERROR - RESTARTED PROM kk , 

PASSWORD EXPIRATION CHANGE INCORRECT. 

PASSWORD RANDOMIZATION NOT PERMITTED PROM 
BATCH. 

PASSWORD TOO LONG. 

PASSWORD TOO SHORT. 

PAUSE PROM JOB jsn 
PAUSE PROM OPERATOR 

pPn PERMANENT ERROR. 

PERMIT LIMIT EXCEEDED. 

PP STAGING DISABLED. 

PP UTILITY ACTIVE. 

PPM ABORTED. 

PID • yyy DOES NOT EXIST IN THE LID TABLE. 

PL ERROR IN DECK doeknatao. 

POSITION ERROR ON• « f 1 ananio. 

POSITION LOST, flldnaiRR AT adcir«ss. 

PDSTAMBLC ERROR. 

PP ABORT. 

PP CALL ERROR. 

PP CALL ERROR. 

PREMATURE EOR/EOP ON SOURCE PILE. 

PRIOR TAPE ASSIGNMENT LOST. 


Bpcausc RESTART dotpctod a parity arror in 
attampting to restart from tna spacified 
cNackpoint nn, tha altarnata cHaekpoint kk 
was usad instaad. 

TNa axpiration data or axpiration tarn 
valua you antarad is incarraet on your 
PASSWOR command or you are not allewad to 
ehano# your password axpiration data. 

YOU antarad a PASSWOR command from a 
non*interactiva jeP when password 
randomization is roRuirad. Whan password 
randemisation is raquirad, PASSWOR can 
only da antarad from an interactiva job. 

You antarad a PASSWOR command with a naw 
password tnat is too long. Tha naw 
ONSSwerd cannot oxcaod savon eharactors 
ineluding randemization charactor 5 . 

Either you have password randomization 
required and specified fewer than two 
nonrandom characters for the naw password 
specification in a PASSWOR command or 
the new password was shorter than tha 
minimum password length required by the 
Site. 

A PAUSE command was i ssuad to tha job by 
tha job jsn. 

A PAUSE command was issued to the job by 
the console operator. 

Tha specified file resides on alternate 
Storage and has data arrers that must be 
eorraetad. The arror flag must be 
cleared or tha file must be reloaded from 
a backup copy. 


A PERMIT command or macro cannot be 
processed because tha file specified 
alroady has the maximum number of permits 
a 1 lowed. 

Tha file must be stagod from alternate 
storage to disk and aithar CARTRIDGE PF 
STAGING or TAPE PP STAGING, or both, have 
been disabled. 

Tha operation was not attempt ad because a 
permanent file utility was currant 1 y 
activa. 

PPM was unabla to continue due to an 
operator OVERRIDE, or CPUPPM abortod 
prior to completing its transfer. 

The specified PIO could not be found in 
tha LID Sable. 


The program library specified by the P 
option in tna RRONREP command was 
incerroet 1 y formatted. 

Pile filoname was not rapesitionad after 
being ehackpointad because CHKPT datoetad 
an address arror. 

A block ID mismatch exists or tha block 
ID window is an ones. This indicates 
that a NOS terminator label mismatch 
exists. 

In aithar case, tha position on tho tapo 
cannot ba established and tha job will 
tarminato. 

A missing or dafoetiva pestamblo was 
dot act ad at tsoo cpi. Tha dayfila massage 
status ERROR, filename AT address praeadas 
this massage and specifies tha file 
(filanams) and tha address. 

System error in PPU. 


Tha monitor dotoetod an error in a CPU 
raquast for PP action. 

Error datoetad in PP call due to hardware 
or RECLAIM error. 

Tha systara anceuntarad an and*ef-raeord 
(EOR) or ond*of*fi1a fEOP} in the seurco 
filo bafora it preeassad all tha 
Informatian. 

Magnetic tape axaeutiva has baan droppad 
along with tapes assigned. All of the 
jab's prior tape assignments are lost. 


Nona. 


Retry using tha 
correct axpiration 
date or term. 


Resubmit PASSWOR from an 
interactive job. 


Correct tha naw password 
specification and 
resubmit. 


Correct tha naw password 
specification and 
resubmit. 


None. 


Nona. 


Inform site analyst. 

I f tha file is on 
MSE. the site analyst 
may be able to 
correct tha problem 
with SSOEBUG; 
Otherwise, the file 
must be purged or 
re 1 oadad. 

Nona. 


Contact site 
personnel to 
determine why staging 
has baan disablad. 

Waft unti1 tha PP 
utility is net active 
and ratry. 

Inform site analyst. 


Chack to soa if you 
have specified tha 
correct PID. 

Chack that tha PL is a 
MODIFY DPI. 


Nona. 


Clean tha tape path. 


Ratry or inform site 
analyst. 


Examine tho job dayfila 
to determine tho causa. 

Verify that tha correct PP 
call is issuad. 

Inform sit# analyst. 


Ramovo tha extra EORs 
and EOPs from tha source 
f i la. 


Prom an interactiva job. 
raturn/unload all prior 
tapes and reassign. a 
batch job aborts and 
must be rerun. 


RESTART 

MODVAL 

MODVAL 

MODVAL 

MODVAL 

1RI 

IRI 

PPM 

PPM 

PPM 

PPM 

PPM 

LISTLID 

KRONREF 

CHRPT 

tMT 

IMT 

RECLAIM 

1AJ 

RECLAIM 

OeCMBNT 

RESEX 


•OAStBAO L 


■ •47 



MESSAGE 


SICWIFICANCE 


ACTIOW 


ROUTIWE 


FROCEOURE pppppp NAS HO FORMAL PARAMETERS 

PROCESSING OPTION CONFLICT. 

PROCESSING OPTION NOT APPLICABLE. 

PROCESSOR DETECTED MALFUNCTION. 

PROCESSOR STATE ERROR. 

PROGRAM FILE EMPTY. 

PROGRAM STOP. 

PROGRAM STOP AT APdr«sS. 

PROJECT EPILOGUE MOT FOUND. 

PROJECT NUMBER EXPIRED. 

PROJECT PROLOGUE FILE NOT LOCAL. 

PROJECT PROLOGUE NOT FOUND. 


A 1in« BodA call raquasttno hAlp was mada 
to an intaractiva proeadura that has no 
paranatars dafinad. Exaeution centinuas 
following tha massago. 


Both ring anforcoMont options (POsR and 
POsW) or nera than ana EOT option (POet, 
POsP. and POtSl has boon spaeifiad. This 
massaga can also occur if PO«Z or PO*P is 
spaeifiad for an 1- or S!*fermat tapa. 


Tha proeassing options P0>R and PO>D ara 
allowad only on a COPY conKsand copying 
from Mass storage or an 1 or SI-binary 
format tapa to an s or L format tapa. 

Tha processing option PObT is allowed on 
a C0PY8 eeiwaand that ganaratas an E or B 
format tape. 


A hardware error (arror codasEO) such as 
a data or addrass parity arror on doubla 
bit error has occurred. 


A hardware error, or software arror 
resulting in a hardware arror. occurred. 


A lead of an empty file was attempted. 

Tha System processed a program stop (oo) 
instr uetion. 

The monitor detected a program stop 
instruction at tha spaeifiad addrass. 

The epilogue file defined for your charge 
and project numbers could net be found. 

Dayfile and output file massage indicating 
that the project number expiration data has 
occurrad. 

Tha local file 2222PR1 was returned prior 
to the time that it was naadad. 

Tha prologue file defined for your charge 
and project numbers could net be found. 

A shall program with tha no-abort option 
sat was active at the time you attempted 
to specify charge and project numbers 
which had o bpoIooua dafinad. 


Nona. 


Ratry using tha 
cerract paramatar and 
syntax. 


Refar ta the COPY or 
COPYB cooHeand 
description in section 
9. correct tha command, 
and ratry. 


Analyse job dumps, 
maint ananca 
registers, and tha 
arror leg or HPA 
reports to determine 
the causa of tha 
arror . 

Analyse job output, 
dumps, listings, 
maintenance registers 
and the error leg to 
determine the causa 
of the arror. 

Nana . 

Nona. 


Nona. 


Contact site 
personnel. 

Reno. 


Contact site 
parsonna1. 

Contact site 
personnel. 

Specify charge and 
project numbers which 
do net have a 


CCL 

RESEX 

COPYB 

1AJ 

1 AJ 

1 AJ 
1 AJ 

1 AJ 

VALEX 

VALEX 

VALEX 

VALEX 


PROLOGUE AND SHELL CONFLICT 


VALEX 




WESSaCE 


SICWIFICANCE 


aCTION 


ROUTIWE 


RTFS - ERROR IN EXPIRATION DATE. 


Thor« WAS AD error in tne oxpirAtion OAte 
specified on a save or a define Directive 
on A MFLINK commend. 


RTFS • EXECUTE ONLY FILE. 

RTFS • FILE ALREADY PERMANENT. 

RTFS • FILE IS DIRECT ACCESS. 

RTFS - FL TOO SNORT FOR PROGRAM. 

RTFS - HOST NOT SPECIFIED TYPE. 

RTFS ■ INCOMPLETE CONTINUED DIRECTIVE. 

RTFS - INVALID KeywordsVA 1ue. 

RTFS - INVALID ACCESS VALIDATION. 


RTFS • INVALID 
PERMISSION . 

RTFS “ INVALID 

RTFS - INVALID 

RTFS • INVALID 
RTFS “ INVALID 


ALTERNATE CATLIST 

8ACKUP/RESIDENCE REOUIREMENT. 
data DECLARATION TYPE. 

DEVICE SPECIFICATION. 
DIRECTIVE. 


PTFS - INVALID MOOE/CATEGORY. 

RTFS • INVALID xkxxxxsNO VALUE. 

PTFS - LID UNAVAILABLE. 

PTFS - MISSING CHARGE/PROJECT. 

PTFS > MISSING USER NAME. 

PTFS > MULTIPLE FILE TRANSFERS REOUESTED. 


You attenptocf to transfer an execute-only 
file. 


You attempted to save a file that is 
already permanent. 

You attempted to alter a direct access file 
with e REPLACE or APPEND directive. TMis 
is not allowed. 

There is e system error in the remote nest. 

Your joD assumes e non-NOS remote host end 
you have been linked to a NOS remote host. 


The remote host expected the text string to 
Oe a continuation of the previous string 
end it was net. 


You specified an incorrect parameter 
(keyword*velue) . 

Your USER directive has an incorrect user 
name or the specified user name does net 
have job processing privileges on the 
remote host. 


You specified an incorrect value for the AC 
parameter on e SAVE, DEFINE or CHANCE 
command. 

You spoeifiod an incorrect BRsbr or PRspr 
peremeter on one ef your diroetivos. 

You spoeifiod an incorrect ODtdd parameter. 


You specified an incorrect Rsr peremeter on 
your directive. 

The remote host does net recognize the 
directive you specified. 


The mode or category you specified for 
the file ere net defined. 


Argument xxxxxx was entered without a value. 


Tha raguasted LID is net a host LID. is 
disabled, or is e store-forward LID. 

The CNARGE directive did net have the 
required charge and project number. 

The USER directive did net contain the 
required user name. 


You have mere then one file transfer 
directive in e given directive record. 
This is not allowed. 


error message returned by NOS 


Ah error 


.... . -. message nes been received from 

NOS by PTFS. PTFS takes this message, 
prefaces it with e *PTFS - end returns 
the new message to you. 


RTFS - PARAMETERS CE AND CP ARE MUTUALLY 
EXCLUSIVE. 


The parameters CE end CF may 
specified on the seme CHANCE 


net toot n too 
command. 


PTFS - PF NAME RBOUIREO. 

PTFS • FF REOUEST COMPLETE. 

PTFS • RECOVERY DIRECTIVE AFTER FILE 
TRANSFER. 

PTFS > SECONDARY USER DIRECTIVES DISABLED. 


YOU did not specify the permanent filo to 
be processed. 

The remote host successfully processed your 
pertianent file request. 

Your MFLINK directives are net in the 
proper sequence. The USER, CNARGE. or 
FACKNAM directive must precede the file 
transfer directive. 

You ere net authorized to specify secondary 
USER directives. 


Correct the expiration 
date on the SAVE er the 
DEFINE diroetivo end 
reontor the MFLINK 
command. 

RTFS 

Change permanent file 
access to allow road 
permission. 

PTFS 

Purga the file and retry. 

PTFS 

Change directive end 
retry. 

PTFS 

Inform site analyst. 

PTFS 

Inform sito analyst. 

PTFS 

Correct the syntax of 
your diroetivos record 
with emphasis on the 
continuation linos. 

PTFS 

Correct end retry. 

FTFS 

Ensure that the user 
name is correct end 
retry. Inform site 

analyst if the problem 
persiSts• 

PTFS 

Specify a correct 
value and retry. 

PTFS 

Correct the parameter 
and retry. 

PTFS 

Correct the ODsdd 
peremeter and ratry. 

PTFS 

Corract and retry. 

PTFS 

Ensure that the syntax 
ef the diroetivo is 
corract and ratry. 

PTFS 

Correct and ratry. 

PTFS 

Correct remote 
directive and ratry. 

PTFS 

Inform site analyst. 

PTFS 

Correct and retry. 

PTFS 

Correct end retry. 

PTFS 

Place the file transfer 
directives in separate 
records, one file 
transfer directive per 
record. 

RTFS 

Refer to the message 
returned by NOS for the 
epprepriete action 

Ithet is ignore the 
letters *PTFS and 

leek up the message 
itself alphabetieally 
in this appendix). 

PTFS 

Use two separate chance 
commends, with one 
specifying CP end the 
ether specifying CE. 

PTFS 

Correct end retry. 

PTFS 

None. 

PTFS 

Resequence your 
directives end retry. 

PTFS 


Get site personnel to PTFS 

authoriso you er do 
net attempt to use 
secondary USER 
direetives. 


B04SBBBO L 
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tdCSSAgE 


SICNIFICAWCE 


ACTIOW 


HOUTIMg 


FTPS > UNKNOWN ACCESS LEVEL NAME. 


FTPS • USER OINECTIVB REQUIRED FIRST. 
FUR6ALL ASORTEO. 

FURCALL COMPLETE. 

FURCZNC fffffff 

FURCtNC fiAmnmmm. 

QAC ERROR ENCOUNTERED. 

OAP • INCORRECT REQUEST. 

QAP • USER ACCESS NOT VALID. 


QPM FILE NAME ERROR. 


You ontoroO «n unknewn accoss lovol nano on 
a SAVE or a DEFINE dlractivo through « 
MFLINK cofomand. 


You must first spocify a USER diraetivo to 
aecoss pormanont ft las on rometo NOS hosts. 

FURCALL aoortod promaturoly. 


Tho filas hava boon purgod as roquostod. 

Informativo mossaga issuad by FURCALL as 
aaeh fiia is purgad. if tha OF paramatar 
is spaeifiad. 

Fila filanaraa has baan purgad. FURCALL 
issuas this massaga if the DF paramatar 
is spaeifiad. 

Systam arror. 

Sad paramatar in QAP call. 


You triad to parform an operation for which 
you are not authorisad (for axampla, trying 
to use FFC arrays whan not authorised to do 
so) . 


Tha file name specified is not a valid 
file name. 


Correct tha access level 
name on tha SAVE or tha 
DEFINE directiva and 
raantar tha MFLINK 
command. 

Correct and ratry. 


Chock dayfila for 
mere detailed 
nassagas. 

None. 

Nona. 


Nona. 


Inform site analyst. 

Inform CYBER Software 
Support, 

Ensure accuracy of 
command or dotermine 
proper validation 
raquiramants. 

Verify file name. 


Q6ET COMPLETE. 

OTF, •n- qfn ACQUIRED. DCsdc. STsdid. 
OOssid. 


QTF, 'n* qfn CONNECTING TO pid. 


OTF. -n- qfn CONNECTION REJECTED. REASON 
CODE s XXX. 


Informative only. 

The systam has acquired local queue file 
qfn on connection number n from the local 
queue with disposition coda de for transfer 
to destination LID did with source LID sid. 

Tha system is attempting to establish 
communications with remote host pid. 

n QTF connect ion number 

qfn Queued file name 

pid Physical identifier 

The systam was unable to establish a 
eonneetion to the remote host. 

n QTF connection number 

qfn Queued file name 

XXX Reason cede (decimal) 

more details about reason codas, 
refer to tha dascrin^iane m* 


None. 
Nona. 


None. 


If problem persists, 
contact remote 
operator to ensure 
remote subsystem and 
QTFS are operational; 
otherwise contact 
site analyst. 


RTFS 

FTPS 

FURCALL 

FURCALL 

FURCALL 

FURCALL 

ENQUIRE 

OAF 

QAP 

QFM 

QCET 

QTF 

QTF 

QTF 



MESSACE 


SICWIFICAWCE 


ACTION 


ROUTINE 


OTFIS), -n- qfn CONNECTION ESTABLISHED. 

OTF(S), -n- qfn CONNECTION TIMED OUT. 


OTFIS). -n- qfn CONNECTION TO pid ABORTED. 


OTF(SJ. -n- qfn CONNECTION TO pid ENDED. 


OTFCS), COUNT OF ACTIVE CONNECTIONS 
DECREMENTED BELOW ZERO. 

OTFIS). -n- qfn ERROR IN FILE TRANSFER. 

OTF(S). -n- qfn FC/BRK RECEIVED. 


OTFIS), -n- qfn FC/NAK RETRY COUNT EKCEEOEO. 

OTFIS) qfn FIRST KEYWORD IS NOT sROUTE* 

OTFIS) -n> qfn INCORRECT EC FOR THIS OUEUE 
TYPE . 


OTFIS) -n- qfn INCORRECT VALUE (xxx). 

OTFIS] >n* qfn INCORRECT VALUE Ixxxcyyy). 

OTFS, -n* qfn INVALID ATTRIBUTE ICNORED. 


OTFIS). <n* qfn INVALID SEOUENCE RECEIVED. 

OTFIS), JOB ORIGIN ERROR. 

OTFIS), -n- qfn MESSAGE FROM REMOTE HOST > 
OTFIS), -n- qfn xxx. 


Indieatos stats of cennaction to romoto 
host part nor. 

n OTF connactien numoar 

qfn Ouauad fila nana 

Ramota host partnar did not raspend within 
tha allowed time span. Transfer will ho 
ratr tad. 

h OTF eonnsetion number 

qfn Oueued file name 

Indicates state of connactien to ramota 
host partnar. 

n OTF connection number 

qfn Ouauad fils name 

pid Physical identifier 

Indicates state of connection to remote 
host partner. 

n OTF connection number 

qfn Ouauad file name 

pid Physical identifier 

The applieat’.on received a disconnect but 
had no paths active. 

Transfer of file qfn was unsuccessful. 

h OTF eennaetien number 

qfn Oueued file name 

The remote host partner brohe the network 
connection. Usual cause is detection of an 
unraeeverable protocol anomaly. 

n OTF connection number 

qfn Oueued file name 

The subsystem was unable to deliver a 
network massaoe. 

n OTF connection number 

qfn Oueued file name 

The MFOUEUE routing directive must begin 
with tha keyword ROUTE. 

n OTF connection number 

qfn Oueued file name 

The external characteristics lEC) value 
Specified on a MFquEUE routing directive 
dees net match the disposition code of the 
f i le. 


n OTF connect 1 on number 

qfn Oueued file name 

You specified an incorrect keyword xxx on 
an MFOUEUE routing directive. 

n OTF connection number 

qfn Oueued file name 

You spaeifiad an incerract valua yyy for 
keyword xxx on on MFOUEUE routing directive. 

h OTF connection number 

qfn Oueued file name 

OTFS received a natwerk massaga from the 
remote host OTF with an unrecegniaed 
parameter. Transfer may eemplata. 

R OTF eennaetien number 

qfn Ouauad file name 

A natwerk message from tha ramota host 
partnar was raeaivad that was net in 
sequence. 

n OTF eennaetien number 

qfn Oueued file name 

OTF or OTFS was improperly initiated by 
user command. 


xxx is the text of a message received from 
the remote host partner. 

n OTF connect ion number 

qfn Oueued file name 


"'TWORk aioCKS OUT OF A n.tvork lussae* *ro» tn# rmet. hest 

sEousNCE. partner was received that was not in 

soquanea. 

n OTF eonnoetlen number 

qfn Ouauad file name 


None. PTF 

OTFS 


If error porsists, OTF 

inform site analyst and OTFS 

disable remote host pid 
in subsystem ID table. 


Nona. 


OTF 

OTFS 

None . 


OTF 

OTFS 

1nform 

site analyst. 

OTF 

OTFS 

If erre 
inform 

>r persists, 
site analyst. 

OTF 

OTFS 

If error porsists, 
inferiB site analyst. 

OTF 

OTFS 


Inform sito analyst. OTF 

OTFS 


Correct tha MFOUEUE OTF 

routing directivo. OTFS 


Correct the MFOUEUE OTF 

routing directive using OTFS 


a prinftypa EC value if 
tha fila is a print 
file, or a punch-type EC 
value if tha file is to 


ba punched. 

Correct tha MFOUEUE OTF 

routing directiva. OTFS 

Correct the MFOUEUE OTF 

routing directive. OTFS 

Inform site analyst. OTFS 


Inform site analyst. OTF 

OTFS 


Nona. 

OTF 


OTFS 

Nona. 

OTF 


OTFS 


Inform sito analyst. 

OTF 


OTFS 


BOASBSBO L 
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SICMIPICAHCE 


ACTIPW 


AeUTIME 


OTF(S J, 


qfn NETXFR ERROR rc - rmjnmss 


An •rror oceurrsd during filn trdnsfdr. 

n OTF cenndctfon nunbdr 

qFn OunuAd fild na»d 

re Reason cede 

rejness Reject nessege 


tnFerin site analyst if 
problem persists. 


rc reimess 

03 CONNECTION OROKEN. 

04 PROTOCOL ERROR. 

0$ TIMEOUT EXPIRED. 

OS RLOCK MOT SENT. 

07 TOO MANY TRANSFERS. 

OS ACN OUT>OF>RAH6E. 

09 CIO ERROR. 

13 IDLEDOWN ERROR. 

14 SHUTDOWN. 

15 RHF 1/0 ERROR. 

IB INCORRECT DEVICE. 

17 CODE CONV N/A. (net avail) 

IS CONTROL WORD ERROR. 

19 INCORRECT OBVICE. 

30 EMPTY FILE. 

31 NAM INTERFACE ERR. 

32 BLK NUM MISCOMPARE. 

23 INCORRECT BLK $I2E. 

3S SLOCK SEOUENCE ERR. 

2S PRU ROUNDS ERROR. 

27 INTRA'HOST PRO XFR. 

2S ERROR DURINO XFR. 

29 ARL OUT OF NANCE. 

30 APPL NOT VALIDATED. 

31 FILE TYPE ERROR. 

32 JOB ORIGIN ERROR. 

rlir** **** USERNAME FOR «OC*WT/TT« OTFS is unab 1 e to accept a file for the 

wait queue because ne user name exists 
with which to associate trie file. 


n OTF connect ion number 

OTF(S) -n» qfn ROUTE ERROR nnB^xxxx. OTFS was unable to queue the queued file 

(qfn) due te one of the reasons in the 
following list. nn is the DSP error 
cede, and xxxx is the reason. 


INVALID DISPOSITION CODE. 
INVALID ST OR DO LID. 
INVALID TERMINAL ID. 
INVALID FORMS CODE. 
INVALID JOB COMMAND. 
INVALID DATA DECLARATION. 
INVALID INTERNAL CHAR. 
INVALID EXTERNAL CHAR. 
INVALID SPAC1H6 CODE. 

TOO MANY DEFERRED JOBS. 
INVALID USER ACCESS. 
INVALID USER COMMAND. 


Specify UN*u$ernamo 
parameter on MFOUEUE 
routing directive. 


If RETRY LATER, no 
action is required; OTF 
will periodically retry 
to transfer the file 
until the temporary 
condition clears. For 
all other reasons, the 
file is evicted and the 
log file is returned te 
originator. Correct the 
ROUTE command or MFOUEUE 
routing directive, if 
possible; otherwise 
inform site analyst. 


OTF 

OTFS 


OTF 

OTFS 


OTF 

OTFS 



MESSAGE 


sicwrricAMCE 


ACTION 


ROUTINE 


©TF(S). qfn UNKNOWN *FI* PARAMETER. 

DEFAULT USED. 


OTFISl. -n- oFn UNKNOWN STATE•OF>TRANSFER 
SENT SY REMOTE HOST. 

OTFCSJ, -n- qfn REASON CODE « nnnnnn - 
(CONTACT SITE ANALYST], 


9TF(S). qfn UNRECOGNIZED COMMAND 

RECEIVED XX. 


OTFCS). 'n* qfn UNRECOGNIZED MESSAGE 
RECEIVED. 


OUEUE LIMITS EXCEEDED ON REMOTE 
MAINFRAME. 


OUEUET ARGUMENT ERROR 


UNSPECIFIC TRANSFER 

Insufficiont infernatien was raeaivao Dy 
tha rameta host partnar to allow tho 
transfar to eontinua. 

OUEUE TYPE UNAVAILABLE. 

Tha disposition coda raquastod on tha ROUTE 
command or MFOUEUE routing diraetiva could 
net ha preeassad on tha raaeta host . For 
axampla. a print fila was attaiaptad to ba 
transFarrad to a CYBER 200 ramota host. 


UNACCEPTABLE ATTRIBUTES. 

An invalid attributa value was raeaivad by 
tha ramota host partner. 

Tha ramota nos 2 system raeaivad a print Nona, 

fila with an unknown PI (print•imago) 
parameter. Tha fila will be printed 
using tha default PI paramatar. 

n OTF connect ion number 

qfn Ouauad file name 


An unraeogniaad value, 
stata-ef-transfar attr 
a network massage from 
partner. 


nnnnnn. for tha 
but a was raeaivad on 
tha ramota host 


Inform site analyst. 


n OTF connection number 

qfn Ouauad file name 


Tha command sent by tho ramota host partner inform site analyst, 
is not raeognisad. 


n OTF connect ion number 

qfn Ouauad file name 

XX Command number raeaivad 


The network massage raeaivad from the inform site analyst, 

subsystem is net recognised. 

n OTF eonnaetion number 

qfn Ouauad file name 


OTF 

OTFS 


OTF 

OTFS 


OTF 

OTFS 


OTF 

OTFS 


A batch job was entered from a card Retry later. lAU 

•■••Oar or routed from another mainframe 

with an ST paramatar on the job command, 

but tha job could net run on tha 

specified remote mainframe because tha 

usar had tee many jobs active on that 

mainframe already. 

Yau entered tha oUEUET command incorractly. Cheek tha command OUEUET 

format, than reenter tha 
command. You may antar 
a OUEUET,SYNTAX command 
to display the command 
format. 


RANDOM INDEX ERROR. 


Tha random disk address of tho permit 


Chock your program. If 


PFM 




NESSACE 


sicmr iCAiiCE 


ACTION 


NOUTIWE 


RECLAIM ARGUMENT ERROR. 

RECLAIM COMPLETE. 

nnnnnnnnnn RECORD SPLITS OCCURRED. 
RECORD TOO LARGE ON f i 1 . 


RECORD TOO LONG . 


R RECORDS NOT REPLACED. 


RECOVERY COMPLETE...CONTINUE 

RECOVERY RERUN. 

REMOVABLE PACKS OVERCOMMITMENT. 

RENAME NOT ALLOWED FOR RROC OR TEXT RECORD. 

REPEAT.. 

REPLACE ERROR. 


An invAlid argumont was dotsetAtf in tha 
RECLAIM COIMIAnd. 


NernAl complotien. 


Multipla blocks poF roeerd havo boon 
wRittan an an S or l output tapa. 


An input raeerd 
axeaadad S or L 


was oneeuntarad that 
output tapa block $isa. 


Tha raeerd is toe long for available 
aonery. In response to a WBR request, tha 
raeerd length parameter was greater than or 
equal to tha Job's field length. Available 
nemery i$ filled and the excess data is 
skipped. 

Infermative message. LIBEOIT encountered n 
records en a replacement file that were net 
named in the directives and did not replace 
old file records. 


•Job recovery was successful. 


The system is rerunning the job following a 
level 3 deadstart. 

Removable pack repuest without NA selected 
caused resource overeomraitment. 


A RENAME of a PROC or TEXT type record was 
Attempted; this {5 not allowed. 

Data will new be accepted by the network. 

The same file was found twice during a 
catalog search. This error can occur for 
APPEND or REPLACE commands or macros after 
A file is found and purged and the catalog 
search is continued ferror leg and dayfile 
message). 


Cheek the RECLAIM 
command for correct 
parameters, values, etc. 

None. 

None. 


Reduce input record 
size, use COPY 
command to increase S 
or L tape block size, 
or allow record 
splitting with PO 
paramet er. 

Increase field length 
and rerun. 


Either change the 
directives so that 
the replacement file 
is a nwreplaee file 
er include a «16N0RE 
directive listing the 
records that are net 
to be used. 

Issue a STATUS directive 
to determine the state of 
the job. then proceed. 

No action required. 


Retry later er retry 
with NA parameter on 
ATTACH. DEFINE, etc., 
with PN parameter 
specified. 

None. 


None. 

Inform site analyst. If 
many of these errors 
occur, the site analyst 
should perform a full 
PFOUMP. total INITIALIZE, 
and full PFLOAD on the 
device. 


RECLAIM 

RECLAIM 

COPYB 

COPYB 

CPMEM 

LIBEOIT 

HELL07 

1 AU 

RESEX 

LIBEOIT 

CCP 

PPM 



MESSAGE 


SICWIFICAHCE 


ACTIOW 


AOUTIME 


REQUESTING DUMP FILE. 


REQUIRED Ft EXCEEDS VALIDATED LIMIT. 


RESEQ COMMAND ERROR. 
RESEO ERRORS. 


RESEQ NUMERIC 
RESERVED FILE 
RESERVED FILE 


PARAM ERROR. 

NAME . 

NAME . 


RESEX ABORT ■ OPERATOR TERMINATION. 

RESEX ABORT - SYSTEM RESOURCE LIMIT. 


RESEX ABORT > TERMINAL INTERRUPT. 

RESEX FAILURE. 

RESOURCE DEMAND ERROR. 

RESOURCE ENVIRONMENT ERROR. 


RESOURCE NEGATIVE SHARE COUNT. 


RECLAIM fs roquQsting the dump file 
spAcified toy the TN or ON option. 

RECLAIM will try to road it and rebuild 
the database antrias for this dump file. 

The Job raquiras leora fiald langth than you 
are authorised to have. 


The RESEQ eommand contains a syntax error. 


wait for RECLAIM to 
finish the request 
and issue another 
massage. 

Decrease the job site or 
request the site to 
increase your field 
1 engt h va1idat Lon. 

Correct error and rerun. 


A resequencing error was encountered. 


A parameter wnich is supposed to be numeric 
contains a nonnumorlc character. 


Refer to preceding 
message for mere 
Specific information 
about the error. 

Correct error and rerun. 


Road or destination file name matches an 
internal scratch file (ZZZ22BQ-2222ZC7). 


Rename file and reenter 
command. 


File name specified on SORT command is 
reserved for use by the editor tZZZZZCO. 
ZZZZZC1). 


Rename file and 
rerun. 


The operator entered a DROP. KILL or RERUN 
command. The system performed appropriate 
cleanup procedures before termination. 

The job terminated prematurely due to job 
time limit, SRU limit, or track limit. The 
system performs appropriate cleanup 
procedures before termination. 


You entered the interrupt or terminate 
sequence. The system performs appropriate 
cleanup procedures before termination. 

The resource executive fRESEX) has detected 
a fatal error. 


Determine reason for 
operator action. Rerun 
job if possible. 

If error was caused 
by SRU or time limit, 
increase resource 
limits. If caused by 
track limit, contact 
site analyst. 

None. 


Write a PSR. 


You attempted to decrease the number of 
scheduled units to less than the number of 
currently assigned units or increase the 
number of scheduled units to a point where 
a deadlock would occur. 

System error. 


The resource overcommitment algorithm 
indicates a greater number of users are 
sharing a removable pack than are 
actually sharing the pack. 


Adjust RESOURC command 
parameters accordingly. 


Reenter the command or 
rerun the job. If the 
problem reoccurs, inform 
your site analyst or 
contact CYBER Software 
Support. 

Reenter the eommand or 
rerun the job. If the 
problem reoccurs, inform 
your site analyst or 


RECLAIM 

L 18EDIT 

RESEQ 

RESEQ 

RESEQ 

XEOIT 

SORT 

RESEX 

RESEX 

RESEX 

PFM 

RESEX 

RESEX 


RESEX 
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SlCWlFlCAMCe 


ACTIOW 


HeUTIWE 


RNF, jebn AFFLICATION IS NOT NETTED ON 

RMF, OUFLICATE NETON REQUEST. 

RHF. FATAL SSF ERROR. FCsfe. Rdre. 
RHF. INVALID APPLICATION CALL TO RMF. 


RHF. INVALID APPLICATION NAME ON NETON. 

RHF. INVALID APPLICATION TABLE ADDRESS. 

RHF. jsn INVALID FET PRAM. FET s Qddrfiss. 
RHF, jsn INVALID HEADER ADDRESS Address 
RHF, INVALID MINACN/MAXACN ON NETON. 

RNF. INVALID SSF UCP ADDRESS address 
RHF. INVALID TEXT ADDRESS address. 

RHP. NETON SECURITY VIOLATION 

RHF, NO APPLICATION ADDRESS IN RNF 
CALL-^eXTRA CHARGE 


RMF. QUEUED MESSAGE LIMIT EXCEEDED 


The appi feat ion i»4th jab rtame or job 
sequence nane jobn requastad an RHF 
function bafara raquasting a NETON to RMF. 
RHF aborts tha application. 

Two NETON requests were made For the same 
application without an intervening NETOFF 
request. RHF aborts the application. 

System error. 

An application issued an invalid RHF call. 
The call may contain an incorrect RHF 
Function, a request (ether than NETON) From 
an application with an ond*oF>job connect 
status, or an incorrect word count in the 
RNF call. RHF aborts the application. 

An application issued a NETON request using 
an application name that was net in RHF's 
conFiguration or that contained incorrect 
characters. RHF aborts the application. 


None. 


RNF 


Remove the second NETON RHF 

request or add the 
missing NETOFF request. 

InForn site analyst. RHF 

Correct error in RHF 

application and retry. 


Correct name in the RHF 

application NETON call 
or add the application 
name to RHF's 
cenFiguration. 


In an RHF call, an application usad an 
ineerract application tablo address. The 
address may be out oF rango or may point 
to another application table. RHF aborts 
tha application. 

System error. 

System error. 

The value For the minimum or mawimum ACN in 
the NETON request is outside the range 
speciFied For the application. RHF aborts 
tha application. 

Systam arrer. 

Systam error. 


An application is not validated to do a 
NETON requast. RMF aborts the application. 

InFermative massago indicating an 
application issued an RHF request (other 
than NETON) without spociFying an 
application tablo address in the RMF call. 
The application is charged lass iF it 
spaciFias its application table address in 
aaeh RMF call. 


An application axcaedad the meximun number 
OF supervisory messages that are queued in 
RHF. RHF aborts tha application. 


Correct error in RHF 

eppiication. 


Inform site 

anaiySt. 

RNF 

Inform site 

analyst. 

RHF 

Correct the 
maximum ACN 
appiication' 
request. 

minimum or 
in tha 

S NETON 

RHF 

Inform site 

analyst. 

RHF 

Inform sito 

analyst. 

RHF 

None. 


RHF 

None. 


RHF 


Modify the application RMF 

to issue mere Frequent 
NETGCTs For the 
supervisory massaqas 



MESSAGE 


SICWIFICANCE 


ACTIOW 


SOUTINE 


SOUTE INCORRECT ^ST* PARAMETER. 

ROUTE «JSN* NOT ALLOWED. 

ROUTE COT* NOT ALLOWED. 

ROUTE «RRI> IGNORED. 

ROUTE «REP* GT 63. DEFAULT 41SEO . 

ROUTE •TIO* AND «FM/UN» CONFLICT. 

ROUTE »TID/FM/UN* and »ID* CONFLICT. 

ROUTE UNDEFINED SERVICE CLASS. 

ROUTE UNKNOWN *P1» PARAMETER. 


fn«n«ni« ROUTED. JSN IS jsn. 

RPV > PREVIOUS ERROR CONDITIONS RESET. 
RTIME nnnnnn.nnn SECS. 

RUN COMPLETE. 

SC ONLY PARAMETER VALID WITH USN. 

SCP INCORRECT TRANSFER ADDRESS. 


SECONDARY APPLICATION AOORTED CONNECTION. 

SECONDARY APPLICATION CONNECTION LIMIT. 

SECONDARY APPLICATION FAILED. 

SECONDARY APPLICATION NETTED OFF. 

SECONDARY APPLICATION NOT AVAlLARLE. 

SECONDARY APPLICATION PROCESSING COMPLETE. 
SECONDARY APPLICATION REFUSED CONNECTION. 

SECONDARY USER COMMANDS DISABLED. 

SECURE FILES - CHECKPOINT ABORT. 

SECURE MEMORY. DUMP DISABLED. 


THtt STslid p«r«m«tar on th« ROUTE cemniand 

HAS an ineorraet fernat. 

lid Leoieal idantifiar af ranota 

ma inframe. 

Correct the format of 
your ST t1 id 

Specifieation. 

ROUTE 

Your jab is net systam origin, and only 
systam origin jobs can spacify tna jSN 
paramat or. 

Do net attempt to use 
the JSN parameter 
unless your job is 
syst em origin. 

ROUTE 

Your job is not systam origin and only 
systam origin jobs can usa tho OT 
paraiROtar. 

Do net attempt to use 
the OT parameter 
unless your job is 
system origin. 

ROUTE 

Informativa massaga; this paramatar is 
allowad (but ignorad) for NOS/BE 
eoMpatibi 1 ity. 

None. 

ROUTE 

Tha rapaat count spaeiPiad was graatar than 
63: it has baan sat to o. This condition 
deas not abort tha program. 

Use a repeat count loss 
than or equal to 63. 

ROUTE 

Tha TIO paramatar was spacifiad with aither 
tha FM or UN paramatar. Naithar ona of 
thasa paramatars can ba spacifiad along 
with TIO. 

Refer to section 9 for 
the correct format of 
the ROUTE command. 

ROUTE 

The ID paramatar was spacifiad with tha 

TIO. FM, or UN paramatar. 

Refer to section 9 for 
tne correct format of 
the ROUTE command. 

ROUTE 

Tha spacifiad service class was not 
raeognized. 

Correct and retry. 

ROUTE 

The ROUTE command contains an incorrect Pi 
paramatar. 

Check with site 
personnel to 
determine the correct 
value to be 
specified. 

ROUTE 

filename is tha name of the file which was 
routed. jsn is tna job sequence name (JSN) 
assigned to tha file. 

None . 

MFILES 

Normal message on RPV reset call. 

None . 

RFV 

Dayfile message output by RTIME command 
giving the roal'-timo seconds count. 

None . 

1 AJ 

Completion message for jobs in all 
subsystams except batch. 

None . 

lAFEX 

You included an OT. L. or OP parameter 
along with a jsn parameter on a class 
command. If you specify a JSN paramotor, 
the only other valid paramatar for CLASS is 
the SC paramatar. 

Correct the CLASS 
command parameters and 
resubmit. 

CLASS 

The SCP SSCR (RA * SIB) word contains 
ineerroet parameters or tha eemplotien 
addross for an SF.RECR. sf.swpx or SF.SWPO 
function Is no longer within the sCP field 
longt h. 

Correct cede error in 

SCF. 

1 AJ 

You intantione 1ly or unintentienally 
aborted the secondary eonneetien. Possible 
causes are security conflict or entry of a 
BYE.ABORT coffimand. 

If the abort was 
unintantienal and you 
cannot establish a 
cause, see your site 
analyst. 

TLX 

Tha application you specified on an APPSW 
command is busy with tha maximum allowable 
number of terminal eenneetiens. 

Try again latar. 

TLX 

Your secondary application has failed, 
probably due to a systam problem. 

Check with your site 
analyst or try again 
later. 

TLX 

The application was brought down by the 
network eporeter. 

Check with your site 
analyst or try again 
later. 

TLX 

The secondary application requested on an 
APPSW eemmend is either temporarily 
unavailable or is net supported at your 

Site. 

Cheek with your site 
anelyst. 

TLX 

The eonneetien to your soeondary 
application has baon tarminatod normally. 

None. 

TLX 

The application refused to accept your 
connect ion. possibly as a result of a 
validation problem or security conflict. 

Check with your site 
analyst. 

TLX 

You attempted to specify a USER command 

To a second user name, but your site has 
disabled this usage. 

Log in again or 
submit a saparata 
batch job. specifying 
the second user name. 

VALEX 

Indicates a local file being cneekpeinted 
tied secure file status sot. 

None. 

CHKFT 

You either attempted to dump memory 
protected by the system or entered a 
mamery dump raquest after a pretacted 
command or from a terminal. 

Rafor to Security 

Control in NOS 

Reforonco Sot. Volume 

3 or user Field 

Length Dump Request 
in Volume 6. To 

1 AJ 
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MCSSACE 


sicmyicAiieE 


ACTIOW 


WOUTIHE 


SECURE RASSWORO ENTRY REOUIRCD. 

SECURITY CONFLICT. 

SEE DAYFILE'UNABLE TO LOAD pfn. 


SELECT BY NUMBER OR TYRE 0 TO OUXT 

SELECTION DOES NOT MATCH MENU LIST 

SERVICE CLASS FULL. 

SERVICE CLASS FULL. 

SERVICE CLASS REOUIREO WITH JSN. 


Ne pRrAfiiAtars mmy be entered on the 
PASSWOR eeiMeentf w password randomi sat fen 
is required. 

An attempted operation within the job would 
have resulted in a violation oV security 
access levels or categories. The cause is 
described in the immediately preceding 
dayfile message. 

RECLAIM is unable to load Vile pfn due to 
bad tape, database in error, the file is 
already permanent, or some ether problem 
as indicated in the dayfile. 


Normal prompt for a menu procedure called 
in line mode. 


On a line 
response. 
represent 


mode menu procedure call or 
the value entered does net 
a valid menu selection. 


You attempted to change a job to a service 
class For which the service class limit has 
already been reached. 

The number of jobs in a particular service 
class has reached its limit. 


You entered a CLASS command with a JSN 
parameter but did net Include an sc 
parameter. if the JSN parameter is 
specified, an SC parameter must also be 
inc1uded. 


obtain memory dumps 
from an interactive 
job. include the dump 
command in a 
procedure or in an 
ENTER command. 

Retry RA5SW0R without 
any parameters. 


Correct and retry. 


Check the dayfile for 
the specific error. 

Check your permanent 
file catalog to ensure 
that the specified file 
is net already in the 
catalog. If the file is 
not already permanent, 
check the database file 
and dump tape. 

Make the appropriate 
menu selection in 
response to the 
prompt(s). 

Make the appropriate 
menu selection in 
response to the 
prompt, or reissue 
the command with a 
valid selection. 

Resubmit the CLASS 
command at a later time. 


Retry logging in at a 
later time or contact 
site administrator to 
increase the number 
of jobs allowed in 
particular service 
class. 

Correct the CLASS 
eonmand parameters end 
resubmit. 


scow t re 


MOOVAL 

lAJ 

RECLAIM 

CCL 

CCL 

CLASS 

lAFEX 

CLASS 



MESSAGE 


ROOTIME 


SIGHIFICANCE 


ACTION 


SFP/DOO TEXT=XXXXXXX, MSG=nnnn. 


Identifies the system text 
and message number causing 
the immediately previous 
SFP/DOO diagnostic. 


Follow instructions 
for the previous 
SFP/DOO message. 


SFP 
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MESSAGE 


SIGNIFICANCE 


ACTION 


ftOUTlME 


SFF/xxx FARAMETER ERROR. 

SFP/PFE I/O SEOUENCE ERROR. 

SFP/SRP SPECIAL REOUEST PROCESSING ERROR. 

SFP/STS UNKNOWN DEVICE TYPE/NAME. 

SHARE TABLE ERROR. 


OAyfiltt nASsago indicatfng that tha 
paranotar addrass was eutsida tha fiald 
langth. 


Action was raquastad on a file that was 
alraady busy. 

Dayfila ntassaga indicating that tha SPCw 
word was busy. 


Tha davica coda is not racognisad by tha 
systam. 

System error. 


jsn SHARE TABLE MISMATCH. A systatn error occurred while processing 

tha job with the specified job sequence 
name (jsn). 


SINGLE FRAME ERROR. 


SL NOT VALIDATED. 


A frame (NRZ2 only) containing all zeros 
was read; data will be at least one frame 
Short. Tha dayfila massage STATUS ERROR, 
filename AT address precedes this 
message, and specifies the file 
(filename) and the address. 


The SRU limit requested is zero. 


SPCW CALL ERROR. 


SPECIAL 


REOUEST PROCESSING ERROR. 


A DMPs 
ea 1 led 

have a 


type call was made, and the 
is either net in the CLD or 
OMP* entry point defined. 


program 
dees not 


Error encountered in cSPCW* call 


word. 


SPECIFY EXACTLY 3 CHARACTERS ON LID 
KEYWORD. 


SPECIFY EXACTLY 3 CHARACTERS ON PIO 
KEYWORD. 


The value specified for the LID Keyword 
or the ST Keyword must be exactly three 
characters long. 

The value specified for the PID Keyword 
must be exactly three characters long. 


•SRU LIMIT* 

ENTER S TO CONTINUE OR STOP TO END JOB STEP. 
TYPED AHEAD INPUT MUST BE REENTERED. 


You have exceeded your system resource unit 
(SRU) limit during a terminal session. 


STACK PURGING NOT 0ESELECTA8LE. 

pfn STAGE INITIATED. 

STATION DOWN 

STATUS ERROR, filename AT address. 

STEP CONDITION. 

SUBMIT COMPLETE. JSN IS jobseq 

SUBMIT ERROR > RETRY 


You attempted to change the purging bit 
with the EREXIT function. This cannot be 
dene on BOOO or CYBER TO systems. 

The file dees net reside on disK. It is 
currently being staged from alternate 
storage to disK. 

The SCOPE 2 station is net currently 
executing. 

An error was encountered during magnetic 
tape processing. A second message line 
describes the error in mere detail. 

Step mode flag set in the PSD register 
caused the program to interrupt at the end 
of a program instruction with an exchange 
jump to EEA (the error exit address in the 
exchange package). 

The SUBMIT command successfully queued the 
file for input. The job sequence name 
(JSN) for the job is jobseq. 

An internal error occurred during SUBMIT 
processing. 


SUBMIT FILE EMPTY. 


An EOR or BOP was encountered on the submit 
file before any data was found. 


SUBMIT NOT CALLED FROM HELL07 

SUBSYSTEM ABORTED. 


A SCOPE 2 job requiring terminal I/O was 
not submitted through HELL07. 

Your job was cennoctod (either long term 
connection or wait response set) to a 
subsystem which aborted. 


If the cede is yours, SFP 

find the source of 
the error and fix it. 

If the cede is CDC's, 
write a PSR. 

Wait until the file is SFP 

net busy and rotry. 

Write a PSR. including SFP 

a dump or support 
materials to allow COC 
to duplicate the 
preblem. 

Cheek device cede for SFP 

validity. 

Reenter the command or RESEX 

rerun the job. If the 
problem reoccurs, inform 
your site analyst or 
contact CYBER Software 
Support. 

Reenter the command RESEX 

or rerun the job. If 

the problem reoccurs. 

inform your site 

analyst or contact 

CYBER Software 

Support. 

Retry or inform site 1MT 

analyst. 


Request a non*zero SRU CPM 

limit. 

Inform site analyst. lAJ 

Inform site analyst. lAj 

Correct and retry. LISTLID 

Correct and retry. LISTLID 

To continue, allocate lAFEX 

nnnnn additional SRUs 


with S,nnnnn command or 
enter S alone to 
allocate an 
installation defined 
number of SRUs. 

None. CPM 


Wait until stage PPM 

operation is complete. 


Try to reenter the 0UEUE7 

command at a later time. 

Retry or inform site 1MT 

analyst. 


Inform site analyst. lAj 


None. 


SUBMIT 


Reenter the SUBMIT HELLD7 

directive. If the error 
recurs, inform the site 
analyst. 

Rewind suKxiiit file. SUBMIT 

verify the format of 

the data and that the 

file is a local fila. 

and retry operation. 

Resubmit the job through HELL07 
HELL07. 

Retry later. 1AJ 


BOASBBBO L 
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MgSSACg 


SICWIFICAWCE 


ACTIOli 


ROUTINE 


SYMBOL TABLE FULL. 


SYSTEM ABORT. 


SYSTEM CHECKPOINT ABORT. 

SYSTEM ERROR. 

SYSTEM ERROR. 

SYSTEM ERROR. 

SYSTEM ERROR. 

SYSTEM ERROR. 

SYSTEM ERROR. 

SYSTEM ERROR - NOTIFY SITE ANALYST. 


You cannot defino any nora symbols 
bacauso tho symbol tabla 4s full. 


Fessibla eausos includa tho following: 

• Tha job eontalnad an ineerract USER 
command. 

Tha job attamptad to accass a rastrictad 
subsystan. 

Oparater avictad job. 

Unraeognisabla arror flag appaarad. 

SSjs block outsida fiald langth. 

1RI dotact ad a bad rollout flla. 

1RO dotactad an unraeovarafala axtandad 
namory parity arror during rollout of a 
job's axtandad mamory fiald langth. 

A subsystam has abertad duo to a CHECK 
POINT SYSTEM raquast inltlatad by tha 
oparator. 

A software or hardware systam arror 
occurred. This massage follows a more 
specific massage in tna dayfila. 

The eeamand is net raeognisad by tha system. 

LFM cannot complete the raquastad LFM 
function because the calling program has a 
OMF> entry point. 


Raquastad function cannot be eomplatad 
because tna calling program has a OMRs 
entry point. 

Tha system terminated tha job due to an 
interna 1 arror, 


Your job was aborted because of an 
operating systam software arror. 


Undafina one or more 
symbols to make room 
for tha new one. 

If tha causa was an 
incorrect USER command 
or an attempt to access 
a restricted subsystem, 
correct the job and 
rerun. Otherwise, 
inform a site analyst. 


None . 


Refer to action for 
the associated 
massage. 

Retry command. 

Inform site analyst 
or write a FSR and 
includa support 
material so that 
COC can duplicate 
tha problem. 

Contact CYBER Software 
Support. 


Log in again. Inform 
site analyst or write 
a FSR and include 
support material so 
that COC can 
duplicate the 
problem. 

Contact site 
personnel and write a 
FSR. 


An internal software arror has occurred. Write a FSR and includa 

support materials to 
allow COC to duplicate 
the problem. 


0EBU6 


lAJ 


1CK 


FFM 

MODVAL 


lAFEX 

BLANK 

RESEX 


LFM 


lAFEX 


1AJ 


DROF 

OCET 


SYSTEM FULL . 


The queued file tabla fOFT) is full; no 
new jobs can log in. 


Wait a few minutes 
and retry login. If 


lAFEX 



MESSAGE 


SICWIFICAWCE 


ACTIDW 


ROUTIWE 


TAPE FORMAT PROBAELT WRONG. 

TAPE FUNC REJ function. 

TAPE NUMBER FILE EMPTY. 

TAPE READ/WRtTE ERROR (BLANK) 

TCS INCORRECT REOUEST. 

pfn TEMPORARY ERROR, TRY LATER. 

TERMINAL BUSY. 

TERMINAL DISABLED BY NOP. 

TERMINAL INTERRUPT. 

TERMINAL NOT ACTIVE. 

TERMINAL TIME OUT • JSN s m*mm. 

TERMINAL TIMEOUT IN nn SECONDS. 

THE STATION IS NOT LOGGED INTO SCOPE 2 

THIS CONNECTION IS ALREADY LOANED. 

THIS WOULD DESTROY DEBUGGER. 

TIME LIMIT. 


■TIME LIMIT* 

ENTER T TO CONTINUE OR STOP TO END JOB STEP. 
TYPED AHEAD INPUT MUST BE REENTERED. 

TIME LIMIT. 

TIMEOUT. 

TL NOT VALIDATED. 

TLX • RPV ALREADY SET. 

TN OR DN MUST BE SPECIFIED. 

TOO MANY ARGUMENTS. 

TOO MANY FILENAMES IN LIST. 


This m«sSAO« is issuod in addition to ono 
of th« following massages: 

BLOCK SEOUENCE ERROR, filename AT addr. 
BLOCK TOO LARGE, filename AT addP . 


Tape drive reieetod the attempted 
function. Printed on the preceding line is 
the name of the current program or coiMiand 
buffer. 

Error in RECLAIM scratch file. 

BLANK label operation was unable to 
complete successfully. 


The translate commands (TCS) program was 
called with an incorrect function code. 

The system has detected a temporary 
problem which prevents it from staging 
your file Ipfn) from permanent storage. 

You attempted to send a message to a 
terminal which was receiving output or had 
an input request outstanding. The message 
was lost. 

The network operator has disabled your 
terminal. No further input is possible. 

RECLAIM processing was terminated due to a 
tarminal user break. 

You attempted to sand a massage to an 
Inaetive terminal. 

Tha tarminal has been logged off after no 
input was raceivad in the 
installation defined timeout poriod. 

No input was received for sovoral minutos. 
The System will log you out eftor nn 
seconds if no input is entored. 

The SCOPE 2 station is not eetivo. 


This error indicates an abnormal condition 
is occurring in lAF. 

You tried to change a mamery location 
within the debugger. 

The oxecutien time limit for a job step 
expired resulting in job termination. 


The system dotectod that the time limit for 
the job step has expired. 


The Job has raached its CPU time limit. 


The user has net responded to a login 
prompt within the syst om** spec 1 f i ad time 
interval (usually about 2 minutes] and the 
terminal was disconnacted. 

The tine limit requested is sere. 


Your program triad to set extended reprieve 
when it was already set. 

A RECLAIM operation was attempted which 
required a dump file name or tape number, 
but neither was specified. 

The number of arguments on the command 
axcoads that allowed by the program. 


The number of filanamos listed after a PP»* 
parameter exceeded 9B9. The directive was 
ignored. 


Ensure accuracy of 1MT 

format (F) parameter 

and label (LB) 

parameter on eeimand 

or macro. If the 

problem still exists. 

clean the tape 

drive or use a new 

tape. 

Press the space bar to CTI 

retry the function. 


Inform site analyst. RECLAIM 

Retry with the same BLANK 

tape or use a 
differant tape. 

Correct the call to TCS iAJ 

and ratry. 

Wait a few minutes and PPM 

try to attach the file 
again. 

Retry operation at a lAFEX 

later time. 


None. CCP 


Mene. reclaim 


hone. lAFEX 


Attempt recovery or log lAFEX 
in again. 


Enter e carriage lAFEX 

return to prevent 
1egout. 

Reenter the commend OUEUET 

later when the station 
is executing. 

Inform site analyst. TLX 


Correct address end DEBUG 

retry. 

If a time limit was set 1AJ 

for tho Job. ineludo e 

SETTL commend requesting 

a longer time limit for 

the job step. If the 

job step time limit was 

the maximum for which 

you arc validatad. 

raquest a largar time 

limit or decrease the 

amount of processing to 

bo performed by the Job 

Step. 

To continue, reset time lAFEX 

limit with e T.nnnnn 
commend or enter T eleno 
to set time limit to an 
installation defined 
default. 

Increase your job*s time RECLAIM 
1imit. 

Respond more quickly to NVP 

prompts. 


Request a non-zare CPM 

time limit. 

None. TLX 


Retry after specifying RECLAIM 

tho file name er tape 
number. 

Reformat tho commend SUBMIT 

with an allowable number iaj 

of arguments. 

Reduce the number of RECLAIM 

files specified end 
retry. 
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TOO MANY FILES 


WESSAgg 


SlgWlFlCAWCE 


ACTION 


NOUTINE 


TOO MANY LIBRARY NAMES SPECIFIED. 

TOO MANY LOCAL FILES. 

TOO MANY PARAMETERS. 

TOO MANY PERMANENT FILES. 

TOO MANY USER LIBRARIES SPECIFIED. 

TOO MANY 7000 JOBS. . .SUBMIT LATER 

TOO MUCH INDIRECT ACCESS FILE SPACE. 

TOO SMALL BUFFER SPACE. 

TOTAL ASSIGNED COUNT ERROR. 


You tiovo Attonptod to routo a soeond filo 
to SCOPE 2 wRon you olroody Navo a filo 
routod to SCOPE 2. 

Tho nunbor of llbrorios spoeiFiod on tho 
LIBRARY cemmAnd oxcoods tno aiAx«nium of 24. 
Tho current glebAl librAry sot roffiAins in 
off oct. 

A RECLAIM Attompt to croAto a TocaI filo 
oxcoodod your sito'dotorminod limit on tho 
AllowAblo numbor of IocaI filos. (RECLAIM 
USAS six lecAl filos AS intornol scrotch 
filos.) 

Mero porAmotors wore ontorod (including 
null pArAiROtors) then Aro Allowod for tho 
comauind. 

Tho numbor of filos in your CAtAlog 
oxcoods your vAlidotion limit. 


Tho numbor of usor librorios spoeifiod 
oxcoods tho numbor ollowod bosod on the 
numbor of system librorios specified. The 
current globol librory sot romoins in 
effect. 

The SCOPE 2 limit for tho number of 
concurrent conneetod Jobs hes been 
roAChod. Tho system will continue to 
reject tho SUBMIT directive until tho 
connected job count is reduced. 

Tho cunulAtivo size of the indirect 
Access files in your cetelog exceeds your 
VAlidotion limit. 


Intornol error. 


System error occurred (sum of individuol 
roseurco Assigned counts differs from 
tetol Assigned count in demend filo 
entry!. 


System error occurred (sum of individuol 
resource demend counts differs from tetol 


Woit until the first job 
completes before 
submitting Another Job. 

Correct tho commend. 


Reduce tho number of 
files to your job or 
reduce the number of 
files to be processed by 
RECLAIM. 

Ensure eceurocy of entry. 


Purge one or mero 
pormonent files to 
A 1lOM you to 
SAve or define 
Additionei files. 

Correct tho commend. 


Retry letor. 


Purge or shorten 
one or mero indirect 
Access f i les t o 

Allow Additionol 
pormonent file spoee. 

Submit A PSR with 
infermetien on how 
to duplicAto the 
problem. 

Reenter the commend 
or rerun the job. If 
the problem reoccurs, 
inform your site 
enelyst or contact 
CYBER Software 
Support. 

Reenter the command 

ar rarun tna 4a»i f« 


HELL07 

LIBRARY 

RECLAIM 


CTR 

lAFEX 

NOTE 

PPM 


LIBRARY 


HCLL07 


PFM 


lEDlT 

RESEX 


TOTAL DEMAND COUNT ERROR. 


RESEX 



WESSACE 


SIGNIFICANCE 


ACTION 


NOUTINE 


T76 RETURNED UNKNOWN ERROR OF nn 

DEAD, 123456.7S9KUNS . 

UECF, 123456.7695ECS. 

OEMS. 123456.78SKUNS. 

UEMT, 12345 6.769KUNS . 

UEPF, 123456.789KUNS . 

UNAOLE TO DROP JOE. 


UNABLE TO PROCESS TERMINAL FILE. 

UNABLE TO RECOVER YOUR UOB 

UNDEFINED ORIGIN TYPE. 

UNDEFINED SERVICE CLASS. 

UNDEFINED SERVICE CLASS. 


UNIDENTIFIED PROGRAM FORMAT. 


A systNRi prrpr h«s occurr«d batw««n NOS «nd 
th« SCOPE 2 station. nn Is m two-digit 
•rrer eedo Moaningful to tho site analyst. 


Informattvo message issued to job dayfile 
at job termination, listing the final 
value of the SRU adder accumulator for 
the job (in units of one thousand). 

tnfornative message issued to Job dayfile 
at Job termination, listing the number of 
CPU seconds used by the job. 


Informative message issued to job dayfile 
at job termination, listing the number of 
mass storage PRUs read and/or written by 
the job (in thousands of PRUs). 


Informative message issued to iob dayfile 
at job termination, listing the number of 
magnetic tape PRUs read and/or written by 
the job (in thousands of PRUs). 


Informative message issued to Job dayfile 
at job termination, listing the amount of 
permanent file activity performed by the 
job (in units of one thousand). 


You attempted to drop the job associated 
with your terminal. It is net possible. 


The file you 
is currently 


specified in a SECHDR command 
assigned to a terminal. 


The SCOPE 
could net 
functions 
mode, was 


2 i 

be 

per 

net 


ob was either in execution and 
rerun, or, due to certain file 
formed prior to the recovery 
recoverable. 


Origin type mnemonic specified is undefined. 


You specified an undefined service class 
value for the SC parameter on the CLASS 
command or the UC parameter on the CHVAL 
command. 


Reenter the command. If 
the same message is 
returned, inform the 
site analyst. 

None. 


None. 


None. 


None. 


None. 


If you want to drop 
another one of your 
jobs, use ENdUIRE.JSN to 
ascertain tneir job 
names. 

Assign the file to an 
appropriate device and 
reenter the command. 

None. 


Correct origin type and 
retry. 

Correct the SC or UC 
parameter value and 
resubmit. 


A batch job was entered from a card 
reader or routed from another mainframe 
with an undefined service class specified 
on the job command. 

The file you requested to be leaded was in 
an unrecognisable format. 


Correct and retry. 


Cheek the format of the 
file. 


The tape unit cannot properly write the Resubmit your job, using 
tape. The dayfile message STATUS ERROR. a different tape unit or 
f i lonama AT addracc aroeadac tnie maoxaaa inform site anaivst. 


DUEUET 

1 AJ 

1 AJ 

1 AJ 

1 AJ 

1AJ 

DROP 

SECHDR 

HELL07 

CLASS 

CLASS 

1 AJ 

1 AJ 


UNIT MAS MOTION PROBLEMS. 


1MT 



MgSSACE 


SIGNIFICANCE 


ACTION 


ROUTINE 


UNKNOWN HGt.L. CODE. RECxxx CDyyyy. 

UNKNOWN OFTION > X. 

UNKNOWN SECONDARY AFFLICATION. 

UNLA8ELE0 TAPE REQUIRED - filsnan. 

UNNECESSARY CIO FCT. nnn ON AT 

«ddr»ss. 


UNRECOGNIZABLE TYPE SPECIFIED. 
UNRECOGNIZED BACKSPACE CODE. 

UNRECOGNJZEO CODE SET PARAMETER, 
ppppppp UNRECOGNIZED PARAMETER 

UNRECOGNIZED TERMINATION CONDITION. 

UNRECOVERABLE ERROR ON filpnam. 

UNRECOVERED MASS STORAGE ERROR. 

UNSUPPORTED ATTRIBUTE > xx. 

UNTERMtNATEO PROCEDURE CALL. 

UNUSUAL END-OF-FILE ENCOUNTERED. 

UPDATED typft / nama 

UPROC COMPLETE. 

• USE '*F1LINF0* IN PLACE OF •PRM* CALL 

• SBB . 

USE aFILINFO* IN PLACE OF aSTS* CALL 

• « s « . 

USE SCOPY FOR FILE STRUCTURE. 

USER ACCESS NOT POSS1BLE>CONTACT NETWORK 
ADMIN. 

USER ACCESS NOT VALID. 

USER ACCESS NOT VALID. 


CowniAnd yyyy in raeercf xxx was found to 
contain an ineorroet Nellarith coda. Tha 
job was tarrainatad without axit processing. 

You spacifiad an undafinad option in a 
SECHDR eomniand. 

X Undefined option specified 

On an APPSW command, you spacifiad a 
secondary application that does not exist. 

An s tape used for E, B. or x tape 
conversion must be uniabalad. 

Tha read or write CIO function specified by 
nnn was unnecessary, since your I/O buffer 
was already full (read) or empty Iwrita) 
and no data could be transferred for this 
CIO call. The message is issued to the job 
dayfile only if analyst legging is enabled 
on the system (console entry). 

The type of the source file was not valid. 


The specified backspace code was not O, t, 
2. or 3. 


Parameters PCscsl and NC*es2 specify an 
unsupported conversion. 

The parameter name ''ppppppp*', which was 
entered as a keyword parameter, is not 
defined as a parameter in the procedure 
being cal led. 


The specified termination record count or 
record type was not recognised. 


An unrecoverable error such as wrong 
parity, density change, or ready drop was 
detected on the input file. 

A command or overlay calls a system library 
program. During the lead, an unrecoverable 
read error occurred. 

The value of the attribute is recognised 
but net supported by TRMDEF. 

XX Attribute wnemonie 

A BEGIN or name call to an interactive 
procedure did net have a terminator. One 
or more parameters may be incorrect or 
omitted. 


CTR detected an EOF mark not preceded by an 
EOR mark. 

The record with type and name on the eld 
file was replaced with the matching record 
from the replacement file. 

The prelog you specified in the UFROC 
command has been successfully assigned to 
your user name. 

You used a «PRM« call to obtain file 
permission data. 


You used a «STS* call to obtain file 
allocation data. 

You entered the R parameter on the LIST 
command. The function of the LIST.R 
command has been replaced by the SCOFY 
command. 

Either the application rejected the 
connection, the security count was 
exhausted, or an invalid application name 
mas specified in the local eonfiguration 
file (LCF) . 

You tried to perform an operation for which 
you are net authorised. Possible causes 
include attempts to access a file or 
equipment which you are net authorised to 
access. 

YOU tried to perform an operation for which 
you are net authorised. Possible causes 
include attempts to do the following: 

• Run a system origin job from nen^system 
origin. 

• Access e restricted subsystem without 
proper validation. 

• Use the V carriage control character 
without validation. 


Correct command in error. 


1AJ 


Reenter the cenmand with SECHDR 
correct option. 


Correctly 

specify a 

TLX 

secondary 

applieation. 


Use unlabeled tape. 

COPYB 

Ignore or 

correct 

IMS 

progrem t 
efficient 

e be more 



Check type of source LOTS 

file. 

Refer to the COPYB COFYB 

command description, 
correct the error, and 
retry. 

Verify conversion and FCOPY 

retry. 

Check the parameters CCL 

for the procedure 
being used, correct 
and reissue the 
command. 

Refer to the COPYB COPYB 

command description, 
correct the error, and 
retry. 

Either the tape was bad COPYB 

or the tape drive is 
ma 1 f unctioning. 

Inform site analyst. lAU 


None. 


TRMDEF 


Cheek parameters CCL 

displayed on screen and 
verify or correct before 


proceeding. 

Dump file to determine CTR 

file format error. 

None. COPYL 

None. MODVAL 

Use a »FILINF0* call to SFP 

obtain the desired 
infermation. 

Use a eFlLlNFO* Call to SFP 

obtain the desired data. 

Enter SCOPY.fn. for file lAFEX 

Structure information. 


Contact the network NVF 

administrator. 


Ensure accuracy of LFM 

command or determine 
proper validation 
requirements via LIMITS 
command. 


Ensure accuracy of lAFEX 

command or macro, or MSI 

determine proper OFSP 

validation requirements RESEX 
via LIMITS command. iMA 
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MESSAGE 


SICMiriCAWCE 


ACTION 


ROUTINE 


USER ACCESS NOT VALID. 


USER ACCESS NOT VALID. 
USER ACCESS NOT VALID. 


USER ACCESS NOT VALID. 
USER ACCESS NOT VALID. 


USER BREAK TWO ENCOUNTERED. 

USER CANNOT SWITCH FROM A SECONDARY 
APFLICATION. 


USER CANNOT SWITCH TO CURRENT 
APPLICATION. 

USER COMMAND HAS NOT BEEN EXECUTED. 

USER DATABASE MISSING. 

USER DAYFILE PROCESSED. 

USER DIRECTIVE INCORRECT. 


Tn« us«r nana or oasswerd could not bo 
VAlidotod, or m socondary USER eoianand was 
oneountorod whflo socondary USER commands 
woro disabiod. 

Verify that user name 
and password are valid. 

If secondary USER 
commands are disabled, 
ensure that no secondary 
USER commands are 
present. 

CPM 

You attomptad to uso RECOVER tn a 
nonlntoraet Wo job. 

Initiate an interactive 
Job to use RECOVER. 

RECOVER 

You mado an unautherisod call to a utility 
I'osorvod for systom origin privilagod usors. 

Ensure that you have 
system origin privileges 
before using this 
ut i T ity. 

FOTD 

SUBSYSr 

Tho SRU or timo limit roquost is outsido of 
your validatod rango. 

Retry with a lower value. 

CONTROL 

Ono of tho following oecurrod: 

You aro not author 1 sod to eroato 
diroet aceoss or indlroct accoss 
f I los. 

* You aro not autherlsad to aceoss 
auxiliary dovlcos- 

' Your Job mado a CATlIST roquost for 
permit information on a filo that 
has a higher accoss level than that 
of your Job. 

Contact your site 
administration about 
obtaining the necessary 
validations. For 

CATLIST request, 
resubmit the request 
after raising your Job's 
access level. 

PPM 

InformatIvo message. 

None . 

1 AJ 

You attempted to enter an APPSW command 
from a secondary application. 

To return to your 
primary application, log 
out of your socondary 
application. ir you 

wish to switch to a 
third application, you 
can enter another APPSW 
command from your 
primary application. 

TLX 

You tried to switch to the application 
you are already using. 

Try a different 
application. 

TLX 

A SUBMIT cUSER directive could not be 
processed because your job had not 
processed a USER command before eallinq 
SUBMIT. 

Enter a valid USER 
command, then retry 

SUBMIT. 

SUBMIT 

The specified database file was net found 
and could net be constructed. 

None. 

RECLAIM 

The Job's dayfile dump is complete. 

None. 

DAYFILE 

Cither your Job has not yet processed a 

USER command, or the eUSER directive is 
positioned incorrectly within the file. 

The SUBMIT CUSER directive must be the 
second line in the fn*** 

Enter a valid USER 
conmand, if you have 
net yet dene so. 

Ensure that your file 
is formatted 

SUBMIT 




MESSAGE 


SI6WIFICANCE 


ACTION 


AOOTIWE 


USER RROLOCUE NOT FOUND. 

USER FROLOCUE NOT FOUND. 

USER RETRY LIMIT. 

USER SECURITY COUNT EXHAUSTED. 

USER SECURITY COUNT EXHAUSTED. 

USER VALIDATION ERROR. 


USER VALIDATION LIMIT EXCEEDED. 

VALIDATION FILE BUSY • TRY AGAIN LATER 

etna VALUE INAPPROPRIATE 

VE ENTRY REQUIRED 


Although « usor preleguo was clofinod, it 
could not bo oeeossod. 


Tho proleguo Vilo ctofinod For your usor 
nono could not bo found. 

Four unsueeossful ottonpts ot login uoro 
ntodo oftor uhich tho torminol oos 
discennoctod from tho system. 


Tho security count for tho usor nomo 
spociftod has boon docromontod to soro. 

You aro doniod all access to tho operating 
system until tho operator resets your 
security count. 

A batch job was entered from a card 
reader or routed from another mainframe 
which could not execute because the user 
security count for the specified user 
name had been exhausted. 

You are not validated for this subsystem. 


A validation limit has been, reached for a 
job step or account block. The limit is 
either a time limit or an SRU limit. 


Tho validation routine (MOOVAL) was unable 
to access the validation file to perform 
the requested UPROC. PASSWOR. or CHVAL 
eperation. 

The value you specified in the terminal 
definition command emd is net appropriate 
for your terminal. 


The user should either 
delete tho prologue 
definition or create a 
prologue file. 

Recreate your user 
prologue file. 

Obtain accurate login 
inforioatien before 
attempting to log in. 
Inform site analyst if 
problem persists. 

Contact site personnel 
to reestablish access. 


Contact site 
per Sonne 1 concerning 
your user security 
count. 


Try a different 
SutoSytem or contact 
your site 

administrator to get 
validated for the 
desired subsystem. 

If appropriate, have 
Site administrator 
increase validation 
limits. 

Try again later. 


Choose an appropriate 
value (refer to appendix 
U). 


A level o deadstart is required to add or Level o deadstart is 

Change a CMROECK VE entry. required. 


VERIFICATION ERROR. PASSWORD NOT 
CHANCED. 


Password was entered incorrectly when Retry PASSWOR with 

verification of the new password was the correct password, 

requested. 


One or mere of the parameters specified in Compare the parameters 

a VERIFY was not recognized. specified with the 

command description. 


VALEX 

VALEX 

NETVAL 

CPM 

lAJ 

lAFEX 

lAFEX 

MOOVAL 

CCP 

REC 

MOOVAL 


VERIFY ARGUMENT ERROR. 


VERIFY 



MESSAGE 


SlCNiriCAMCE 


ACTION 


NOUTIME 


WAITING FOR MAGNET. 

WAITING FOR NFL. 

WAITING FOR FN8pAcknaniN. typ«. 

WAITING FOR RESOURCE FILE. 


WAITING FOR RESOURCES. 

WAITING FOR SERVICE CLASS TO CHANGE TO x. 

WAITING FOR STORAGE. 

WAITING FOR STORAGE (CM). 

WAITING FOR STORAGE (EM). 

WAITING FOR VALIDATION FILE. 

WAITING FOR VSNc VSn. typ«. 


Tho Job is WAiting for too mognotic taps 
subsystom to bo octivatod. 


Informativo mossago stating tfiat your Job 
bas boon cfolayad and/or rollod out 
waiting for NFL spaco. TRo Job has not 
boon abortod; it will ovontually centinuo. 
THo mossago is visibla via ENOUIRE. 

Tho Job is waiting for tho eporotor to 
mount pack paeknamo on dovico typo typo. 


Tho Job is waiting for tho rosourco domand 
fila or VSN filo to baeerao availablo. 


Tho Job is waiting for sufficient rosoureos 
to allow assignment of tho tapo/pack 
without causing a system deadlock. 

Service class x has reached its service 
limit and a Job is waiting for a place in 
it. 

Issued to DSD • and J displays. 010 is 
waiting to increase its field length or for 
a buffer to become available. 

The job is waiting for additional central 
memory to be made available. 


The Job is waiting for additional 
extended memory to be made available. 


The Job is waiting for the validation file 
to become available to process a UPROC, 
PASSWOR or CHVAL command. 

The Job is waiting for the operator to 
mount the tape with VSN vsn on the 
specified type (MT, HO, PE. or 6E). VSN* 
SCRATCH indicates that any scratch tape is 
acceptable. 


Wait for the operator to 
activate MAGNET or 
terminate the Job. 

None. 


wait until the operator 
mounts the requested 
pack or terminate the Job. 

Wait until resource file 
becomes available or 
terminate the Job. To 
operator: if Job is not 

relied out and this 
message persists, inform 
Site analyst or drop the 
Job. If the operator 
decides to override an 
interrupted Job at this 
point, the preview data 
in the demand file is 
net Cleared and the E.P 
display continues to 
snow the vsN request 
associated with the Job 
unti 1 you log off or 
issue a subsequent 
request for tape or pack. 

Wait until the resources 
become available or 
terminate the Job. 

None. 


None. 


Wait for additional 
storage or terminate 
the Job- 

Wait for additional 
storage or terminate 
tne Job. 

Try again later. 


Wait for tne operator to 
mount tne tape or 
terminate the Job. 


RESEX 

PFM 

RESEX 

RESEX 


RESEX 

CLASS 

1 10 

IMA 

IMA 

MOOVAL 


RESEX 



MESSACE 


SICWIFICAMCE 


ACTlOW 


AOUTlIiE 


WRITE ON READ'ONt.y FILE. 


WRITE ON READ-ONLY FILE. 


KITE ON READ-ONLY FILE f«1«nani« AT addross. 


WRITE ON READ-ONLY PRIMARY FILE. 


WRITE ON READ-ONLY PRIMARY FILE. 


WRITE OVER LA8EL INCORRECT. 


Eithar you attanptad to writ# on a file 
with write lock-out or the direct access 
file was hot attached in write node. 

Either you attempted to write on a file 
with write lockout, or the direct access 
file was hot attached in write mode. 

Either you attempted to write on a file 
with write lock-out or the direct access 
file was net attached in write node. 

Either you attempted to write on a file 
with write lock-out or the direct access 
file was net attached in write node. 

Cither you attempted to write on a file 
with write lockout, or the direct access 
file was not attached in write mode. 

You attempted to write over the VOLI lafeiel. 


WRITE TAPE MARK FAILURE, filename AT An error occurred while trying to write a 

address. tape mark and read it back. 


WRITE VERIFY FAILURE, filename AT address. 

WRONG PARITY, filename AT address. 

XO/XT EXCEEDS MAXIMUM. 

XL lUFFER/FET PARAMETER ERROR, filename 
AT address. 

YOUR PASSWORD EXPIRES AT hh.mm.ss ON yy/mn/dd 

ZZZZ2LD NOT ON MASS STORAOB. 

200 BPI WRITE INCORRECT. 

7000 JOB EARLY ABORT 

7000 JOB ERROR - ERRORixxx 

7000 JOB EXITING 

7000 NOT AVAILABLE 

7000 SYSTEM ERROR 


The tape was positioned properly, but the 
current block cannot be read due to a 
triple track error. 


A seven-track tape is being read in 
opposite parity from which it was written. 


The XO parameter for a password or file 
permission is mere than the maximum number 
of days past the current date, or the XT 
parameter is larger than the maximum 
allowed. 

Message resulted from one of the following: 

HDR1 label in extended label buffer or 
FCT contains a nennumerie display cede 
value in a numeric field. 

- Character count in header word preceding 
labels in the extended label buffer dees 
net egual so. 

You should change your password prior to 
this date. If you do net change your 
password prior to this date, you will 
net be able to login. 

The directory file ZZZZZLD does net reside 
on fxass storage. 

The tape unit <8f7 or S77) cannot record 
data at 200 bpi. 

A submitted Job aborted before it was able 
to connect to the terminal. 

The SCOPE 2 connected job encountered error 
condition xxx. as described in the Record 
Manager section of the SCOPE 2 Diagnostic 
Handbook. 

Indicates nermel completion of a SCOPE 2 
job step. 

The SCOPE 2 mainframe is net available. 


A system error has occurred on SCOPE 2. 


Reattach file In write 
mode or clear write 
inter lock. 

Reattach the file In 
write mode or clear 
write interlock. 


Reattach file in write 
mode or clear write 
Int or lock. 


Reattach file in write 
mode or clear write 
inter lock. 


Reattach the file in 
write mode or clear 
write interlock. 


Have the operator blank 
label the tape. 

Clean the tape drive 
or use a cleaned or 
new tape. If it 
still fails, contact 
a customer engineer. 

Clean the tape drive or 
use a cleaned or new 
tape. 


Ensure accuracy of 
format parameter (F) on 
command or macro. 

Correct XO or XT 
parameter and retry. 


Correct eondltlon that 
caused error and retry. 


Contact site personnel 
if you are net familiar 
with your site policy 
regarding passwords. 

Assign the directory 
file to mass storage. 

Specify a different tape 
density. 

Check the Job's dayfile 
for an error indication. 

Refer to the SCOPE 2 
0iagnestie Handbook. 


None. 


Wait until the 
SCOPE 2 mainframe Is 
avaiTable. 

Wait for SCOPE 2 to 
recover. 


IMS 

lAFEX 

IMS 

IMS 

lAFEX 

IMT 

1MT 

IMT 

IMT 

PPM 

IMT 

VALEX 

lAJ 

IMT 

HCLL07 

HELL07 

HELLC7 

HELL07 

HELLO? 
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GLOSSARY 
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Abort 

To terminate a program, job or job step 
when an error condition (hardware or 
software) exists from which the program 
or computer cannot recover. 

Access Category 

Refer to File Access Category, Job 
Access Category Set, and System Access 
Category Set. 

Access Level 

A property of each file, job, and equip¬ 
ment on a secured system that is used to 
indicate the sensitivity of information 
in the file or job, or the sensitivity of 
information that can be processed by the 
equipment. On a secured system, there 
are up to eight access levels correspond¬ 
ing to increasing levels of sensitivity. 
You are authorized to access some or all 
of those levels. Refer also to Equipment 
Access Levels, File Access Level, Job 
Access Level, and System Access Levels. 

Access Level Limits 

Refer to Job Access Level Limits. 

Account Block 

That portion of a session from login to 
logoff or entry of a CHARGE command 
which signals a new account block. 

Allocatable Device 

A storage device allocated by the system 
without operator intervention that can 
be shared by more than one job. 

Alphanumeric 

Consisting of alphabetic or numeric 
characters only. 


Application 

A program resident in a host computer 
that provides an information storage, 
retrieval, or processing service to a 
remote user via the data communication 
network. LAF is an example of an 
application. 


Application Switching 

The process of leaving the control of one 
application and entering the control of 
another, without going through another 
complete login sequence. 

Argument 

Refer to Parameter. 

ASCII 

American National Standard Code for 
Information Interchange. The standard 
character set and code used for informa¬ 
tion Interchange between systems. 

Auxiliary Device 

Mass storage permanent file device used 
to supplement storage provided by the 
normal permanent file devices associated 
with the system (refer to Family Device). 


BASIC 

1. Beginner's All-Purpose Symbolic 
Instruction Code, an elementary 
programming language. 

2. The subsystem that uses the BASIC 
compiler. 
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Beginning-of-Information (BOI) 


Checkpoint 


A file boundary that marks the beginning 
of a file. You can reference the BOI by 
name. For a labeled tape file on a 
single volume, the HDR.1 represents BOI. 
If the file is a multivolume (multireel) 
tape file, BOI is the HDRl label of the 
first volume. If the tape file is an 
ANSI multifile file, BOI is the HDRl 
associated with the beginning of the 
multifile. 


An abbreviation of binary digit. It is a 
single digit, 0 or 1, in a binary number. 
Also used to represent the smallest unit 
of information. A central memory word 
(one storage location) contains 60 bits. 

Block 


The process of writing to a magnetic tape 
or mass storage file a copy of your job's 
central memory, the system information 
used for job control, and the names and 
contents of all assigned files that are 
identified in a CHECKPT request. 

Checkpoint File 

File on which the results of a partially 
completed job are dumped when a check¬ 
point request is processed. 

Command 

A sequence of words and characters that 
call a system routine to perform a job 
step. The command must conform to format 
specifications. You can usually place a 
comment after the command terminator. 


Blocking is the grouping of user records 
for efficiency in transfer between memory 
and storage devices. For magnetic tapes, 
it is the information between interrecord 
gaps. 


Refer to Beginning-of-Information. 


An abbreviation for bits per inch. 
Refer to fci. 


Byte 

A group of 12 bits. Five bytes comprise 
a 60-bit central memory word. Bytes are 
numbered 0 to 4 from the left. 


Catalog 

The list of names of permanent files be¬ 
longing to a particular user name; this 
list also contains information about the 
permanent files. 

Character 

Any alphabetic, numeric, or special 
symbol that can be encoded. This term 
applies to the graphic characters for an 
input or output device, and to uniquely 
encoded control characters used by a 
terminal. 


Command Record 

The first, and possibly only, record of 
a job file consisting of command images 
that start with the Job command and end 
with the first EOR, EOF, or EOl. Also 
refers to a procedure containing 
commands. 

Compile 

To translate a program from a higher 
level programming language (for example, 
FORTRAN or BASIC) into machine instruc¬ 
tions called object code. 

Control Character 

1. A terminal-dependent character that 
is a part of interactive status 
commands and terminal definition 
commands. It gives these commands a 
preemptive status so that they are 
processed immediately. 

2. A character whose occurrence within 
a file queued for printing, affects 
carriage control. Examples are the 
carriage return and line feed 
characters. 

Control Point 

The portion of central memory that is 
assigned to a job. When a job is allo¬ 
cated a portion of central memory, it 
becomes eligible for assignment to the 
central processor for execution. 
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Control Statement 

Refer to Command. 

Control Statement Record 

Refer to Command Record. 


Characters per inch. A measure of 
density. 

CYBER Loader 

The utility that prepares programs for 
execution by placing program instruction 
and data blocks in central memory. 

CYBER Record Manager (CRM) 

A software product that allows a variety 
of record types, blocking t3T)es, and file 
organizations to be created and accessed. 
Products like COBOL 5, FORTRAN Extended 
4, FORTRAN 5, Sort/Merge 4, Sort/Merge 5, 
ALGOL 5, and DMS 170 use CRM to manage 
execution time input/output. Neither the 
input/output of the operating system nor 
that of most of the system utilities such 
as COPY or SKIPF is implemented through 
CYBER Record Manager. All CYBER Record 
Manager file processing requests ulti¬ 
mately pass through the operating system 
Input/output routines. 

Dayfile 

A chronological file created during job 
execution which forms a permanent 
accounting and job history record. Day- 
file messages are generated by operator 
action or, with some exceptions, when 
commands are processed. A copy of the 
dayfile is printed with the output for 
each job. You must explicitly request 
it in an interactive job. 

DAS 

Refer to Disk Array Subsystem. 

Deadstart 

The process of initializing the system 
by loading the operating system library 
programs and any of the product set from 
magnetic tape or disk. Deadstart re¬ 
covery is reinitialization after system 
failure. 


Default 

A system supplied option used when you do 
not supply the option. 

Detached Job 

An interactive origin job that you have 
dissociated from your terminal by using 
the DETACH command. It continues to 
execute under system control. You can 
reattach an executing detached job with 
the RECOVER command. 


Device 

Peripheral equipment. 


Direct Access File 

A NOS permanent mass storage file that 
can be attached to the your job. All 
changes to this file are made on the file 
itself rather than a temporary copy of 
the file (compare with Indirect Access 
File). 


Directive 

An instruction subordinate to a system 
command. 


Disk Array Subsystem 

A disk storage subsystem. The 5830 Disk 
Array Subsystem allows the configuration 
of multiple disks combined into a single 
logical device. A combination of 5830 
Solid State Disk (SSD) units and 5833 
SABRE units can be configured in a 
single cabinet. 

The 5832 SSD can be configured either as 
a single unit or as two units driven in 
parallel, which increases both the size 
and speed of the device. 

The 5833 SABRE can be configured in four 
ways: 

- As a single unit 

As a single unit with a second unit 
used for parity 

As two units driven in parallel 
As two units driven in parallel with 
a third unit used for parity 
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When a device is configured with a 
parity unit, the data written to the 
device is redundantly recorded. In the 
event of a failure of any single unit on 
such a device, the system can continue 
to access all the data on the device. 
Once the failing unit has been replaced, 
the system automatically restores the 
data on that unit, while still allowing 
access to the device during the 
restoration process. 


Display Code 

A 6—bit character code set used to repre¬ 
sent alphanumeric and special characters. 


Disposition Code 

A two-character mnemonic that indicates 
the manner in which the system is to 
dispose of a queued file. The DC=dc 
parameter of the LDI, QGET, ROUTE, 

SETJOB, and SUBMIT commands specify a 
disposition code. 

EBCDIC 

Extended Binary Coded Decimal Interchange 
Code. An 8-bit code which represents a 
set of 256 characters. 


ECS 

Extended Core Storage. Refer to Extended 
Memory. 


Empty PRU/Record 

A PRU that contains no user data. Refer 
also to Zero-Length PRU. 


End-Of-File (EOF) 

A boundary within a sequential file, but 
not necessarily the end of a file that 
can be referenced by name. The actual 
end of a named file is defined by EOI. 
For labeled tape, EOF and EOI (denoted 
by the EOFl label) are the same. For 
multifile tape files, EOF and EOI do not 
correspond. In the product set manuals, 
an end-of-file is also referred to as an 
end-of-partition. 


End-Of-Information (EOI) 

The end of data on a file. Information 
appearing after this point is not 
considered part of file data. In card 
decks, a card with a 6/7/8/9 multiple 
punch in column one. On mass storage 
devices, the position of the last written 
data. On labeled tape, it is the EOFl 
label. CYBER Record Manager defines end- 
of-information in terms of file residency 
and organization. 


End-Of-Record (EOR) 

An indicator that marks the end of a 
logical record. Also referred to as 
end-of-section. 

End-Of-Tape (EOT) 

A reflective strip near the end of a 
magnetic tape. It is used to signal 
termination of operations on a particular 
tape volume. At least 5.5 meters (18 
feet) of tape must follow this marker. 


Entry Point 

A location within a program or procedure 
that can be referenced from other pro¬ 
grams. Each entry point has a unique 
name with which it is associated. 


EOF 

Refer to End-Of-File. 


EOI 

Refer to End-Of-Information. 

EOR 

Refer to End-Of-Record. 

EOT 

Refer to End-Of-Tape. 

Epilogue 

A program that executes at the end of 
your job or, in the case of a project 
epilogue, at the end of an account block. 
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Equipment Access Levels 

A range of access levels specified for 
each equipment on a secured system. In 
order for a file to be stored or output 
on a given equipment, the file's access 
level must be within the equipment 
access levels for the defined equipment. • 

Error Flag 

A character or bit that signals the 
occurrence or presence of an error. 

EST Ordinal 

The number designating the position of an 
entry within the equipment status table 
(EST) established at each installation. 
Devices are identified in operator com¬ 
mands by EST ordinals. The EST ordinal 
is sometimes referred to as equipment 
number. 

Exchange Package 

A table that contains information used 
during job execution. It is printed as 
part of the output when a job aborts. 

Executable Object Code 

Machine language instructions that can be 
executed directly by the machine. A com¬ 
piled program is composed of executable 
object code. 

Extended Core Storage (ECS) 

Refer to Extended Memory. 

Extended Instruction Stack Purging 

Extended instruction stack purging 
applies to models 825, 835, and 855 only. 
It causes the instruction lookahead regi¬ 
sters to be purged under a wider range of 
conditions than normal. Under normal 
conditions, the lookahead registers for 
models 825, 835, and 855 are purged by 
the execution of a return jump instruc¬ 
tion (010), UEM read instruction (Oil), 
exchange jump instruction (013), or 
unconditional branch instruction (02). 
Under extended instruction stack purging, 
these registers are also purged by the 
execution of any conditional jump 
instruction (03 through 07) or any 
central memory store instruction (50 
through 57 with i • 6 or 7). The 
Instructions that cause instruction 
stack purging vary from model to model 
for other computer systems (refer to the 
hardware reference manual for the indi¬ 
vidual computer system). 


Extended Memory 

Optional additional memory. Variously 
called extended core storage (ECS), 
extended semiconductor memory (ESM), 
unified extended memory (UEM), large 
central memory (LCM), and large central 
memory extended (LCME), depending on the 
model of the computer system. Extended 
memory contains 60-bit words. It has a 
large amount of storage and fast transfer 
rates. Extended memory can be used only 
for program and data storage, not for 
program instructions. Special hardware 
instructions exist for transferring data 
between central memory and extended 
memory. 

Family Device 

Mass storage permanent file device asso¬ 
ciated with a specific system. A family 
may consist of 1 to 63 logical devices. 
Normally, a system runs with one family 
of permanent file devices available. 
However, additional families may be 
Introduced during normal operation. This 
enables users associated with the addi¬ 
tional families to access their permanent 
files via the alternate family. 

Family Name 

The name that is associated with a group 
of permanent file devices. 

fci 

Flux changes per inch. A measure of 
density used with magnetic tapes. Each 
flux change records two bits of 
information (per track); 3200 fci 
encodes 6400 bits of information. If 
you subtract 150 bits for error 
checking, 3200 fci is equal to 6250 cpi 
(assuming 1 bpi per track translates 
into 1 cpi per frame). 

FET 

Refer to File Environment Table. 

Field Length (FL) 

The central memory and extended memory 
assigned an executing job. 

File 

1. A set of information that begins at 
beginning-of-information (BOl), ends 
at end-of-information (EOI), and is 
referenced by a local file name. 
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. That portion of a multifile file 
terminated by an end-of-file (EOF). 

3. Data recorded on a magnetic tape 
beginning after an HDRl label and 
ending before an EOFl label. 

NOS commands requiring a parameter that - 
is a file name refer to definition 1. 
Commands requiring a parameter that 
specifies the number of files refer to 
definition 2. Definition 3 applies only 
to labeled magnetic tapes. 

File Access Category 

A property of a permanent file used by 
the creator of the file on a secured 
system to restrict access of the file to 
a particular group of users. A secured 
system supports up to 32 access categor¬ 
ies, and you are authorized to use some, 
all, or none of those categories. Refer 
also to Job Access Category Set and 
System Access Category Set. 

File Access Level 

A property of each file on a secured 
system used to indicate the sensitivity 
of information contained on the file. A 
file is assigned the current job access 
level by default when it is created or 
stored; the file creator may specify any 
access level for that file that is 
within the set of access levels valid 
for the job, the system, the file 
creator, and (for interactive jobs) the 
communication line to the host 
mainframe. If you access a file on a 
secured system, you must be validated 
for the access level of the file. Refer 
also to Access Level, Job Access Level, 
and Job Access Level Limits. 

File Environment Table (FET) 

A table within a program's field length 
through which the program communicates 
with operating system input/output 
routines. One FET exists for each file 
in use by the program. 

File Information Table (FIT) 

A table through which a user program 
communicates with CYBER Record Manager. 
For direct processing through CRM, you 
must initiate establishment of this 
table. All file processing executes on 
the basis of information in this table. 
You can set FIT fields directly or use 
parameters in a file access call that 
sets the fields indirectly. Some product 
set members set the fields automatically. 


File Set 

One or more tape files referred to by 
the set identifier on a tape assignment 
command or macro. A file set may consist 
of: 

1. One file recorded on a single volume. 

2. More than one file recorded on a 
single volume. 

3. One file recorded on more than one 
volume. 

A. More than one file recorded on more 
than one volume. 

All files within a file set have the 
same set identifier in their HDRl labels. 

FIT 

Refer to File Information Table. 

Flag 

A character or bit that signals the 
occurrence or presence of a particular 
condition. 


FNT 

Refer to Local File Name Table. 


FORTRAN 

1. Formula Translation, a high-level 
language consisting of symbols and 
statements that can be used to 
create a program closely resembling 
mathematical notation. 

2. The subsystem that uses the FORTRAN 
Version 5 compiler. 


Frame 

A tape recording unit made up of one bit 
from each tape track (7 bits for 7-track 
tape and 9 bits for 9-track tape). Each 
frame on a coded tape usually represents 
one character. 

Generation 

The position of a file within a series 
of files, each file developed from the 
preceding file. The generation number 
and generation version number of a tape 
file can be entered in its HDRl label. 
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Global Library Set 


Job 


A set of user libraries you specify on 
the LIBRARY command. The system condi¬ 
tionally searches these libraries when 
it attempts to process a command. 

Graphic 

A character that can be printed or 
displayed. Refer to Control Character. 

Host 

A computer that executes an application. 

lAF 

Refer to Interactive Facility. 

Indirect Access File 

A NOS permanent file that you access by 
making a temporary copy of the file (GET 
or OLD command). You create or alter it 
by saving or substituting the contents 
of an existing temporary file (REPLACE 
or SAVE command). 

Input File Type 

The file type the system assigns to file 
INPUT. Its first record is a command 
record which may be followed by records 
containing data, directives, or programs 
used by j ob steps. 

Instruction Stack Purging 

The process of clearing the instruction 
stack in the central processor. It 
affects the speed and accuracy of the 
central processor. 

Interactive Facility (lAF) 

An application that provides a terminal 
operator with interactive processing 
capability. The interactive facility 
makes terminal input/output and file 
input/output appear the same to an 
executing program. 

Interrecord Gap 

Space skipped between the writing of data 
blocks on magnetic tape. 


Interruption Sequence 

The character or sequence of characters 
that causes an executing program to be 
interrupted (also called the user break 
1 ). 
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A set of commands and the data and 
directives used by those commands. A 
batch job must begin with the Job and 
USER commands. An interactive job is 
all activity associated with a terminal 
session from login to logout unless you- 
detach a job during the session. After 
a job detachment, the terminal session 
becomes a new job. 

Job Access Category Set 

On a secured system, a set of access 
categories is set when the j ob is 
initiated. This set is the intersection 
of your set of validated access 
categories and the system access 
category set. Refer also to File Access 
Category and System Access Category Set. 

Job Access Level 

On a secured system, each job has an 
access level. This is the default 
access level that is assigned to files 
that are created or stored in the job. 

A job's initial access level is the 
lower access level limit for the job. 

The job's access level is automatically 
raised to the access level of any file 
from which information is read. You can 
also change the job access level. Refer 
also to Job Access Level Limits. 

Job Access Level Limits 

An upper limit and a lower limit that 
determine the range of access levels 
that are valid for a particular job on a 
secured system. All files used in a 
given job must have an access level 
within the job's access level limits. 

Job Sequence Name (JSN) 

The unique, system-defined name assigned 
to every executing job or queued file. 

The JSN is a string of four alphabetic 
characters. 

Job Step 

An individual command, procedure or 
loader sequence. A group of job steps 
forms a job stream, command record, or 
procedure file. 

Label 

A block at the beginning or end of a 
magnetic tape volume or file, which 
serves to identify or delimit that 
volume or file. 
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Level Itaiber 

An octal niaaber (0, 1, or 17) in the 
terminating marker of a PRU. A level 
number of 17 designates an EOF. A level 
number of 0 designates an EOR. A level 
number of 1 designates that the line of 
data is from a terminal and is not an 
empty line. 

Library 

1. A collection of programs or routines. 

2. A file containing records that are 
accessed individually. 

3. A file searched by CYBER Loader for 
entry points referenced by a program. 

4. A file containing compressed records 
in Modify or Update format. 

Library File 

A read-only file that can be accessed by 
several users simultaneously or a file 
you specify on a LIBRARY command. 

LID 

Refer to Logical Identifier. 

Line 

A unit of data terminated by a zero-byte 
terminator. Unit used in interactive 
input/output, line printer output, and 
card reader input. 

Line Mode 

A mode of job interaction in which the 
basic unit of interaction is a line of 
data. Contrast with Screen Mode. 

Load Point 

Metallic strip marking the beginning of 
the recordable portion of a magnetic 
tape. Data, including labels, is written 
after the load point. 

Local File 

Any file that is currently associated 
with a job. Local files Include all 
temporary files and attached direct 
access files. 


Local File Name 

The file name assigned to a file while it 
is local (assigned) to a job. The name 
is contained in the local file name 
table. 

Local File Name Table (FNT) 

A system-managed table that contains the 
local file name, the file type, and other 
job control information. 

Locked File 

A file on which you cannot write. 

Logical Device 

One or more physical disk units known to 
the system as a single device. 

Logical Identifier (LID) 

A three-character, alphanumeric string 
used to identify a particular mainframe 
in a loosely coupled network. LIDs are 
identified by your site. 

Logical Record 

A data grouping that consists of zero or 
more PRUs and ends with a short PRU or a 
zero-length PRU. 

Login 

Hie procedure used at an interactive 
terminal to gain access to the system. 

Logout 

The procedure used to end a terminal 
session. 

Loosely Coupled Network (LCN) 

A network of physically connected 
computer systems. The LCN environment 
allows jobs, data files, and messages to 
be transmitted from one computer system 
to another. 


Macro 

A sequence of source statements that are 
saved and then assembled whenever needed 
through a macro call. 
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Mass Storage 

Magnetic disk or extended memory that 
can be accessed randomly as well as 
sequentially. 

Master Device 

Mass storage device that contains your 
permanent file catalog entries; all your 
indirect access files; and all, part, or 
none of your direct access files. 

Multifile File 

A file containing more than one logical 
file. It begins at BOI and ends at EOI. 
On a labeled tape, a multifile file is 
delimited by corresponding HDRl and EOFl 
labels. 

Multifile Set 

A tape file set having more than one 
tape file. 


Network 

A data and message switching and routing 
system used to provide communication 
between terminals, applications, and 
mainframes. 

Network Operator (NOP) 

The network operator manages the communi¬ 
cations elements of the network. Network 
operator functions may be performed at 
the system console, or at a remote 
terminal. 

Noise 

Any tape block less than the minimum 
acceptable block size for its data 
format. Noise is discarded by the 
system. 

Nonallocatable Device 

A device (such as a magnetic tape unit, 
card reader, card punch, or line printer) 
which can be used only by one job at a 
time. 


Object Code 

Executable machine language instructions. 
An object code program need not be 
recompiled each time it is executed. 

Order-Dependent 

Used to describe items which must appear 
in a specific order. 

Order-Independent 

Used to describe items which need not 
appear in any specific order. Param¬ 
eters, particularly those with keywords, 
may be order-independent. 

Origin Type 

A job attribute that indicates how a job 
entered the system. The four origin 
types are interactive origin, batch 
origin, remote batch origin, and system 
origin. 


Packet-Switching Network (PSN) 

A system that provides data communication 
service between different terminals and 
computer systems. The PSN is usually 
licensed ais a common carrier. GTE 
Telenet is an example of a PSN. 

Subscribers use a protocol defined by a 
standards body such as CCITT to Interface 
with a PSN. The packet assembly/ 
disassembly (PAD) access defines the 
terminal interface. The X.25 protocol 
defines the PSN Interface with NOS. 

Panel 

A formatted screen defined using the 
panel definition utility. An 
application program uses a panel to 
display data or to request user input at 
the terminal. 

Parameter 

A value that follows a command name or 
function name and that alters the 
behavior of the command or function. 
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Parity 

In writing data, an extra bit is either 
set or cleared in each byte so that every 
byte has either an odd number of set bits 
(odd parity) or an even number of set 
bits (even parity). Parity is checked 
on a read for error detection and 
possible recovery. 

Passive Procedure 

A procedure that does not have the 
parameter-prompting capability. If the 
call to the procedure contains errors, 
the job step terminates and the procedure 
is not executed. 

Password 

1. A system access word that must be 
used in addition to the user name at 
login. 

2. A file access word that controls 
access to a particular file by 
alternate users. 

Peripheral Processor (PP) 

Ihe hardware unit within the host com¬ 
puter that performs physical input and 
output through the computer's data 
channels. 

Permanent File 

A mass storage file that is cataloged by 
the system so that its location and 
identification are always known to the 
system. Permanent files cannot be 
destroyed accidentally during normal 
system operation. They are protected by 
the system from unauthorized access 
according to privacy controls specified 
when they are created. 

Permanent File Device 

Mass storage defined by your site to hold 
permanent files. 

Permanent File Family 

Permanent files which reside on the 
family devices of a specific system. 


Physical Record Unit (PRU) 

The amount of information transmitted by 
a single physical operation of a speci¬ 
fied device. For mass storage files, a 
PRU is 64 central memory words (640 char¬ 
acters); for magnetic tape files, the 
size of the PRD depends upon the tape 
format. A PRU that is not full of user 
data is called a short PRD; a PRD that 
has a level terminator but no user data 
is called a zero-lengtb PRD. 

Post Radix 

A letter following a numeral that 
indicates the base nmberlng system. 

PP 

Refer to Peripheral Processor. 

Prefix Character 

A character that has a special signifi¬ 
cance to a program or the operating 
system and is used in front of a string 
of characters. 


Primary File 

A temporary file created with the OLD, 
lEW, LIB (interactive jobs only), or 
PRIMARY command. The primary file is 
assumed to be the file on which most 
system operations are performed unless 
another file is specified. There can be 
only one primary file associated with 
your job. 

Private Auxiliary Device 

Auxiliary device associated with a speci¬ 
fic user name. Only that user name may 
create files on the device, although 
other users may be permitted to access 
files which reside on the device. 


Procedure 

A user-defined set of Instructions that 
can be referenced by name. The 
instructions consist of procedure 
directives and system commands. 
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Procedure File 

A file containing one or more procedures. 
Project Epilogue 

An epilogue that executes any time you 
end an account block. 

Project Prologue 

A prologue that executes any time you 
initiate a new account block. 

Prologue 

A program the system executes any time 
you initiate a job (user prologue and 
system prologue) or initiate a new 
account block (project prologue). 

PRU 

Refer to Physical Record Unit. 

PRU Device 

A magnetic tape file or a mass storage 
device. Records on these devices are 
written in physical record units (PRUs). 

PSN 

Refer to Packet-Switching Network. 


Public Auxiliary Device 

Auxiliary device available for access by 
all validated users knowing the correct 
pack name. Additional validation is 
required to create or replace files on 
an auxiliary device. 


Queue Priority 

A number that controls the scheduling of 
a job to and from the rollout queue rela¬ 
tive to other jobs of the seune origin 
type. 


Queued File 

A file you have submitted for job entry 
or a file of job output waiting for 
processing. Ihe queued file may have a 
print, punch, wait, or input disposition. 


Random Access 

Access method by which any record in a 
file can be accessed at any time. 

Applies only to mass storage files with 
an organization other than sequential. 
Compare with Sequential Access. 

Random Access File 

A file whose records are accessed through 
a directory containing the address of 
each record. 

Read-Only Permission 

If you have read-only permission on a 
file, you can read and execute the file. 
You cannot write, modify, append, or 
purge the file. 

Record 

A unit of information. In CYBER Record 
Manager and its language processors, a 
record is a unit of information produced 
by a single read or write request. Eight 
different record types exist within CRM. 
You define the structure and character¬ 
istics of records within a file by 
declaring a record format. 

A NOS record is a second-level subdivi¬ 
sion of a file. It is the smallest 
subdivision that NOS recognizes. A NOS 
record can consist of a group of CRM 
records. 

Recovery 

The process by which you reattach a job 
to the terminal. You could have explic¬ 
itly detached the job using the DETACH 
command or the job could have been de¬ 
tached because of a system failure or 
terminal disconnection before logout. 

You can initiate recovery processing 
with the RECOVER command. 

Reference Address (RA and RAE) 

RA is the absolute central memory address 
that is the starting or zero relative 
address assigned to a program. Addresses 
within the program are relative to RA. 
RA+1 is used as the communication word 
between the user program and the system. 
RAE is the absolute extended memory 
starting address assigned to a program. 
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Remote Host 

A computer connected to your local host 
so as to permit permanent file and queue 
file transfers between hosts. 

Remote Host Facility (RHF) 

An application program that allows you 
to transfer files to and from other 
mainframes connected to a loosely 
coupled network (LCN). 

Rolled Out 

The status of an executing job that has 
been temporarily removed from central 
memory. 

Rubout Characters 

Characters created by pressing the RUB 
OUT key on the terminal. These are con¬ 
sidered null input by the system and are 
required in paper tape output. 

SABRE 

The 5833 SABRE is a disk unit that can 
be configured as part of the 5830 Disk 
Array Subsystem (DAS). It has a 
formatted capacity of 1039 megabytes. 

Scheduling Priority 

The variable associated with an executing 
j ob that controls the scheduling of the 
job for CPU time. 

Screen Mode 

A mode of job interaction in which the 
basic unit of interaction is a screen of 
data. Contrast with Line Mode. 

Secured System 

A system in which a mandatory security 
mechanism has been enabled during 
deadstart. A secured system protects 
information by enforcing restrictions 
based on access levels and access 
categories, and restricts many sensitive 
system functions to security 
administrators. 


Security Administrator 

A secured system prevents users and 
operators from performing certain 
functions that could result in the 
unauthorized disclosure of information. 
These functions can only be performed by 
a person who is designated a security 
administrator. A security administrator 
is always authorized to access the 
highest level of information stored on 
the system. This person performs 
functions in the areas of installation, 
user validation, system operation, and 
system maintenance. 


Security Count 

The number of security violations you 
have left before you are denied access 
to the system. 

Security Unlock Status 

This status of the system console 
applies only to a secured system and 
must be set by a security 
administrator. The console must be in 
security unlock status in order for the 
security administrator to perform 
certain functions that are restricted on 
a secured system. 


Sequence Number 

1. Number at the beginning of each line 
of a file. 

2. For tape labels, number indicating 
position of a file within a file set. 


Sequential Access 

A method in which only the record 
located at the current file position can 
be accessed. Refer to Random Access. 

Sequential (SQ) File 

A file in which records are accessed in 
the order in which they occur. Any file 
can be accessed sequentially. 


C-12 


60459680 N 



Service Class 

A job classification based on a Job's 
origin type or job's status. It deter¬ 
mines how a job is serviced as it flows 
through the system. 

Short PRU 

A PRU that does not contain the maximum 
amount of character data allowed for a 
PRU. Refer to Zero Length PRU. 

Solid State Disk 

The 5832 Solid State Disk is a disk unit 
that can be configured as part of the 
5830 Disk Array Subsystem (DAS). It has 
a formatted capacity of 165 megabytes. 

Source Code 

Code input to the computer for later 
translation into executable machine 
language instructions (object code). 

Special Editing Mode 

A variation of normal input mode (other 
than transparent input mode) in which 
the cancel input character, backspace 
character, and line feed character are 
not treated as special characters but 
are passed to lAF as input data. 

SRU 

Refer to System Resource Unit. 

SSD 

Refer to Solid State Disk. 


Standard Labeled Tape 

A tape with labels conforming to American 
National Standard Magnetic Tape Labels 
for Information Interchange X3.27-1969. 
Also called a system labeled tape. 

String 

A sequence of characters. 


Subsystem Flag 

A character or bit that tells the system 
that a particular subsystem is associated 
with a file. 


System Access Category Set 

On a secured system, a set of access 
categories is set during level 0 
deadstart. This set may consist of 
some, all, or none of the 32 possible 
access categories. While the system is 
running, you may only use access 
categories that are within the set of 
system access categories. Refer also to 
File Access Category and Job Access 
Categories. 

System Access Levels 

On a secured system, a range of access 
levels is set during level 0 deadstart. 
This range may contain some or all of 
the eight possible access levels. While 
the system is running, you may only use 
access levels that are within the range 
of system access levels. 

System File 

A file that can be accessed only by a 
system program. 

System Resource Unit (SRU) 

A unit of measurement of system usage. 
The number of SRUs includes the central 
processor time, memory usage, and input/ 
output resources used for a given job. 

Tape Format 

A parameter that specifies the internal 
recording format of a magnetic tape. 

Tape Mark 

A delimiter written on tapes under 
operating system control to separate 
label groups, files, and/or labels. 
Interpretation depends on the tape 
format. 

Temporary File 

A file that is assigned to your job and 
vanishes once you release it or at j ob 
termination. Local copies of indirect 
access permanent files are temporary 
files; direct access permanent files 
assigned to your job are not temporary 
files. 

Terminal Name 

A network-supplied name used to identify 
the terminal to the network operator. 
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Termination Sequence 

The character or sequence of characters 
that causes an executing program to be 
terminated (also called the user break 
2 ). 

Time SIice 

The amount of CPU or CM time a job is 
allowed to use before the system lowers 
its priority to allow other jobs to 
execute. 

Timed/Event Rollout 

A condition where an executing job that 
has been temporarily removed from central 
memory but will be rolled back into 
central memory only when a specified 
event (such as a file is no longer busy) 
or a specified time period has elapsed. 

Transparent Input Mode 

An input mode in which all characters 
entered at the terminal are sent to lAF 
as 7-bit codes (or as 8-bit codes, de¬ 
pending on the parity) without transla¬ 
tion. Normally, characters entered at 
the terminal are translated and stored 
as 6-bit and/or 12-bit display codes. 

This mode is initiated either with the 
0006 control byte or with the IN=X, 

IN=XK, or IN=XP terminal definition 
commands. In former interactive systems 
this mode was referred to as binary mode. 

Transparent Submit Mode 

The mode used in a submit file to 
transfer information that contains 
reformatting directives without 
processing the directives. 


Unsecured System 

A systan in which the security mechanism 
has not been enabled during deadstart. 
The restrictions based on access levels 
and access categories are not enforced 
on an unsecured system. 

User Break 1 

Refer to Interruption Sequence. 


User Break 2 

Refer to Termination Sequence. 


User Index 

A number the system assigns each user 
name and uses for internal record 
keeping. 


User Index Bash 

A string of four alphabetic characters 
derived from your user index that serves 
as the default user job name (UJN) for 
interactive jobs. It appears on the 
banner page/card of all line printer and 
card punch output. You can ascertain 
your user index hash with the ENQUIRE 
command. 

User Job Name (UJN) 

In general, the user-defined name for an 
executing job or queued file. If you 
fail to specify a UJN, the system uses 
your index hash. The UJN must be a 
string of seven or fewer alphanmeric 
characters. Unlike the job sequence 
name (JSN) , the UJN for jobs is not 
always unique. 

User feme 

A one to seven-character name that iden¬ 
tifies the user to the system and for 
which there is assigned a user index 
that allows access to permanent files. 

User Number 

Refer to User feme. 


Validation File 

File containing validation information 
for all users (user names, passwords, 
resources allowed, and so on). 

Volume 

A reel of magnetic tape. A given file 
can be comprised of more than one volume. 
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Volume Serial Number (VSN) 

A one- to six-character identifier that 
identifies the volume of magnetic tape 
to the system. 

VSN 

Refer to Volume Serial Number. 

Word 

A group of bits (or 6-bit characters) be¬ 
tween boundaries imposed by the computer 
system. A word is 60 bits in length. 

The bits are numbered 59 through 0 
starting from the left. It is also 
composed of five 12-bit bytes, numbered 
0 through A from the left. 

Write Interlock 

Write interlock ensures that only one 
person at a time can attach a direct 
access file in write mode. A direct 
access file that is attached in write 
mode is in write interlock. 

Write Ring 

A circular device inserted into a tape 
reel indicating to the tape unit that it 
can write on that reel. NOS checks for 
the presence of a write ring if you 
request it. 

XMODEM 

XMODEM is the industry standard error 
checking communications protocol used to 
transfer files to and from microcomputers 
and mainframes. Also known as the 
Christensen protocol. 

Files created interactively at a terminal 
and by commands that manipulate coded 
lines contain zero-byte terminated 
records. The image of cards input 
through a card reader also has such a 
terminator. 


In 6-bit display code, two colons create 
12 bits of zeros in the 6A-character set. 
If two consecutive colons occur in a 
file that contains zero-byte terminated 
records, they might be stored in the 
lower order portion of a word and create 
a zero-byte terminator. 


Zero Byte Terminator 

The 12 bits of zero in the low order 
position of a central memory word that 
are used to terminate a line of coded 
information. A record with such a 
terminator in CYBER Record Manager is a 
zero-byte record (Z type record). 


Zero Length PRU 

A PRU that contains system information, 
but no user data. Under NOS, a zero- 
length PRU defines EOF, 


6/7/8/9 Multipunch 

A card with the characters 6, 7, 8, and 9 
multipunched in column 1. Signifies a 
card deck EOI. 


6/7/9 Multipunch 

A card with the characters 6, 7, and 9 
multipunched in column 1. Signifies a 
card deck EOF. 


7/8/9 Multipunch 

A card with the characters 7, 8, and 9 
multipunched in column 1. Signifies a 
card deck EOR. 
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SAMPLE JOB OUTPUT 


D 


This appendix lists the output information printed for the sample job shown below. The job 
consists of the following commands. 


OUTPUT. 

USER,STARSKY,HUTCH. 

GET,PFL. 

ITEMIZE,PFL. 


This job generates three pages of output. The first page is the banner page (shown on D-2), 
the second is the output generated by ITEMIZE (shown on D-3), and the third is the dayfile 
(shown on D-4). 
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OPERATING SYSTEM = NOS 2 


crtndate 


PRINTED - yy/mm/dd 13.48.33 


UJN 

CREATING J 


- OUTPUT 

- ABNS 


FAMILY 
USER NAME 


- MATH 

- STARSKY 


JOB ORIGIN - BATCH. 
SERVICE CLASS - BATCH. 



JJJJJJJJJJJJ 

LU 

AAAAAAAAAA 

AAAAAAAAAA 


MS 

NS 

teassa 

it A A AAA A AA A t 


LL 




sss 

NS 

SSSSPSSS?aS5 

AA 

AA 

4-i 

LL 

AA AA 

AA AA 

BA 


MSMS 

SN 

?S 

5 

AA 

At 


Lt 

AA AA 

AA AA 

PA 

9a 

SN SN 

NS 

S5 


AA 

AA 

JJ 

LL 

AA AA 

AA AA 

pa 

aa 

MS SN 

NN 

sa 


AA - 

AA 

JJ 

LL 

AA AA 

AA AA 


8" 

SM N 

N SN 

SS 


AA 

AA 

JJ 

IL 

AA AA 

AA AA 

pa 

aa 

MS 

SS MS 

SS 


AA 

AA 

JJ 

LL 

AA AA 

AA AA 

pBaaRABBABBa 

SN 

SN NS 

SSS5SSS 

ssss 

AAAAAAA AAA A A 

JJ 

LL 

AAAAAAAAAAAA 

AAAAAAAAAAAA 

paaappaaapp 

MS 

NSNS 

SSSS'S 

'SS«S 

AAAAAAA AltAA 

JJ 

LL 

AAAAAAAAAAAA 

AAAAAAAAAAAA 

pa 

P9 

ss 

SNN 



AA 

A A 

JJ 

LL 

AA AA 

AA AA 

pa 

9« 

ss 

NS 


Sa 

AA 

AA 

JJ. 

LL 

AA AA 

AA AA 


aa 

SM 

NS 


ac 

AA 

AA 

JJ 

LL 

AA AA 

AA AA 

pa 

aa 

MS 

NS 


SS 

AA 

AA 

JJ JJ 

LL 

LL AA AA 

AA AA 

Pa 

pa 

SM 

SM 

s 

SS 

AA 

AA 

JJJJ IJJ 

LLLLLLLLLLLL AA AA 

AA AA 

paaaBa^aaaaa 

NS 

NS 

sssssss 

S<“S< 

AA 

AA 

JJJ JJ 

LLLILLLLILLL aa aa 

AA AA 

faaaaaijpasa 

SM 

SS 



The first line indicates the version of the operating system, the creation date of that 
version (crtndate), the printing date (yy/mm/dd), and the time of day the printing occurred. 

The second line contains the user job name (UJN), as specified on the Job command; family 
name, and job origin. 


The third line contains the job sequence name (JSN), the user name associated with the job, 
and the job's service class. 

The first four block letters indicate the user index hash and the last four, the job's JSN. 
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ITEMIZE OF 

PFL 

FILE 

1 

** UNLABELED *★ 

yy/mm/dd. 10,16.57. 

PAGE 

REC 

NAME 

TYPE 

LENGTH 

CKSUM 

DATE COMMENTS 


ITEMIZE 

1 

INSTALL 

PROC 

62 

6454 




2 

BUILD 

PROC 

65 

3131 




3 

UPGRADE 

PROC 

42 

1242 




4 

TRMINAL 

PROC 

442 

5125 




5 

JOB 

PROC 

22 

6332 




6 

ISF 

PROC 

51 

1240 




7 

PRO 

PROC 

46 

5362 




8 

PL 

PROC 

56 

1450 




9 

GROUP 

PROC 

37 

0104 




10 

XED 

PROC 

133 

0376 




11 

EDPROC 

PROC 

42 

6700 




12 

RWF 

PROC 

17 

0002 




13 

CALC 

PROC 

20 

6034 




14 

EDREC 

PROC 

72 

6640 




15 

BACKUP 

PROC 

107 

1373 




16 

FTN 

PROC 

112 

3504 




17 

AJFILE 

PROC 

34 

2403 




18 

AJL 

PROC 

34 

5236 




19 

MOD 

PROC 

203 

7326 




20 

GENPL 

PROC 

32 

0565 




21 

EDITPL 

PROC 

55 

7101 




22 

PAS 

PROC 

152 

7203 




23 

REL 

PROC 

37 

7154 




24 

CMP 

PROC 

40 

5164 




25 

PSR 

PROC 

125 

6613 




26 

PSRFEAT 

PROC 

47 

3106 




27 

HPSR 

PROC 

21 

5610 




28 

SPRO 

PROC 

26 

5174 




29 

DINDEX 

PROC 

61 

3156 




30 

RINDEX 

PROC 

60 

1331 




31 

INDEX 

PROC 

124 

4474 




32 

AJUST 

PROC 

27 

2560 




33 

* EOF * 

SUM = 

3332 
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ABNS 


CDC NETWORK OPERATING SYSTEM. 


NOS 2 


16.58.59. yy/mm/dd. 


16.58.55.OUTPUT. 


16.58.55. USER,STARSKY,. 

16.58.55. CHARGE,*. 

16.58.55. * CHARGE(1514,5612PAY) 

16.58.56. $PR0L0G,PR0C2,,. 

16.58.56. $SETFS,PROC2/FS=AD. 

16.58.57. PR0C2. 


16.58.58.IFE,OT.EQ.TXO,OTHEROT. 

16.58.58. ENDIF,OTHEROT. 

16.58.58.IFE,$$.NE.$$,END. 

16.58.58. EN0IF,END. 

16.58.58. $REVERT.CCL 

16.58.58. GET,PFL. 

16.58.58.ITEHIZE,PFL. 

16.58.58. ITEMIZE COMPLETE. 

16.58.58. UEAO, 0.002KUNS. 

16.58.58. UEPF, 0.057KUNS. 

16.58.58. UEMS, 0.770KUNS. 

16.58.58. UECP, 0.070SECS. 

16.58.58. AESR, 2.186UNTS. 

16.58.58. $0UT(*/0P=E) 

16.58.58. NO FILES PROCESSED. 

16.58.59.SDAYFILE(OUTPUT,JT=D) 
16.59.00.UCLP, 42, 070, 0.256KLNS. 


The first line lists the job's JSN (ABNS); a site-selected, system or machine identifier; 
the time of job termination (16.58.59); and the current date. The dayfile includes a 
listing of the commands, system-supplied status messages, and program output, if any. 

Spaces precede statiis messages and program output. Each line includes the time the message 
was issued to the dayfile. 

Six of the last nine lines specify the type and amount of system resources the job used. 

This job used 0.002 kilounit of application activity, 0.057 kilounit of permanent file 
activity, 0.770 kilounit of mass storage activity, 0.070 seconds of central processor time, 
and 2.186 system resource units. The first two numbers after UCLP give the machine 
identifier as 42 and the EST ordinal of the printer as 070. The job produced 0.256 kiloline 
(256 lines) of printable output. 

The $0UT and $DAYFILE commands are system-supplied and ensure that the job's dayfile is 
printed. 

Depending on the resources used, additional information may be included in the dayfile. 

Refer to Job Completion in section 3 for the formats of these messages. 
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TERMINAL CHARACTER CONVERSION 


E 


Normal Input mode from an ASCII code terminal uses a 63- or 64—character set where all 
lowercase alphabetlcs are converted to uppercase characters. Under ASCII mode, the 
characters 74 and 76 represent the beginning of a 74xx or 76xx escape sequence. Under 
normal mode, the characters 74 and 76 are treated as data rather than escape codes. ASCII 
and normal modes apply to both input and output. 


DATA INPUT 

The manner in which the system interprets the characters entered from a terminal depends on 
whether you request ASCII or normal mode. For example, if you enter 

aAbBcCdDeEfF 

when in ASCII mode, the central memory equivalent is:t 

Bit position 59 47 35 23 11 0 

Code 

Character 

Code 

Character 


76 01 

01 76 

02 02 

76 03 

03 76 


a 

A b 

B 

c 

C 

04 04 

76 05 

05 76 

06 06 

00 00 


d D e E f F end-of-line 


tPartial words are zero-filled; partial bytes are blank-filled. 
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However, if you enter the characters in normal mode, the characters are mapped into the 
64-character subset of the ASCII character set that contains only uppercase letters; then 
the central memory equivalent is: 


Bit position 

59 



47 

35 

23 


11 


0 

Code 

01 

01 

J 

02 

02 

03 

03 

04 

04 

I] 

05 

05 

Character 

A 

A 


B 

B 

C- 

C 

D 

D 


E 

E 

Code 

06 

06 


00 

00 

00 

00 

00 

00 


00 

00 


Character 

F 

F 





end-of 

-line 






Refer to appendix A for further description of the code sets for interactive jobs. 


DATA OUTPUT 

Data output is in either a 64/63- or 128-character set, depending on whether the terminal is 
in normal or ASCII mode. When the terminal is in normal mode, the codes 74 and 76 represent 
data rather than escape codes. In ASCII mode, 74 and 76 are treated as the beginning of an 
escape sequence. 

Data can also be transmitted to or from a terminal through a paper tape reader. Refer to 
appendix N. 
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CARD FILE DATA CONVERSION 


F 


Data within the system is stored in binary or coded format. Binary data is variable length 
central memory images. Coded data consists of display-code characters. Each coded line is 
stored as an even number of characters. If an odd number of characters is entered, the 
system appends a space to make it even. 

This appendix describes the formats for punch cards. It also describes the conversion 
performed by the system on data transferred between the system and card readers and punches. 

When using the 64-character set, avoid using consecutive colons (00 characters). It is 
possible for these colons to be interpreted as an end-of-line. An end-of-line is defined as 
12 to 66 zero bits, right-justified in one or two central memory words. If consecutive 
colons appear in the lower 12 bits of a central memory word, they are interpreted as an 
end-of-line rather than as colons. 

Example: 

The following characters are punched on a coded card beginning in column 1. 

This appears in memory as follows: 

Bit position 59 47 35 23 11 0 


Code 


Character 


Code 


Character 


Code 


Character 


00 00 

00 00 

00 00 

00 00 

00 00 


end-of-line 


00 00 

00 00 

00 00 

00 00 

01 01 


A A 


00 00 

00 00 

00 00 

00 00 

00 01 


: A 
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However, if 
Bit position 

Code 

Character 

Code 

Character 

Code 

Character 


the characters were copied with the COPYSBF utility, the following appears. 
59 47 35 23 11 0 


55 00 

00 00 

00 00 

00 00 

00 00 



end-of 

-line 


01 00 

00 00 

00 00 

00 00 

00 01 

A : 


* ' 


: A 

01 55 

00 00 

00 00 

00 00 

00 00 


A end-of-line 


Because the COPYSBF utility shifts each line one 6-bit character to the right and adds a 
space, copying nine colons puts 12 zero bits in the last byte of the first word. This is 
interpreted as an end-of-line. 


NOTE 


If a colon is the last character of an input 
line, the system appends a space to preserve 
the colon and then appends an end-of-line. 

If needed, a second space is added to ensure 
an even number of 6-bit characters. Refer 
to figure F-1. 


INPUT CARD FILE FORMATS 

The system reads cards in coded and binary formats. The following conditions apply in both 
formats. 

• A card with a 7/8/9 punched in column 1 is an EOR mark. 

• A card with a 6/7/9 punched in column 1 is an EOF t mark. 

• A card with a 6/7/8/9 punched in column 1 is an EOI mark. 

The remainder of each card is ignored except for columns 79 and 80 of the EOR and EOF 
cards. These colvanns can contain the ke3rpunch conversion mode for the input records that 
follow.Tt Conversion modes are discussed in Coded Cards. 


tThe 6/7/9 keypunch mark is not supported by RBF. 
ttHASP terminals can support other forms of separator cards such as /*E0R and /*E0I. (Refer 
to the Network Products Remote Batch Facility Reference Manual.) 


F-2 


60459680 C 







CODED CARDS 


Cards are read in Hollerith punch code. The 3447 card reader controller converts the 
Hollerith code to internal BCD code and passes the data to the card reader driver. The 
driver converts the data from internal BCD code to display code. Up to 80 characters can be 
transferred per card. Trailing blank characters are deleted. If a line has an odd number 
of characters, one trailing blank is added to make it even. In order to preserve the colon 
(000) of the 64-character set, a trailing blank byte is either retained or appended as the 
last character in an even line. Examples of coded card conversion are shovm in figure F-1. 


inversion Modes 

Two conversion modes, 026 and 029,t exist for the Hollerith punch code. All data is 
converted in the system default keypunch mode unless a conversion mode change is specified. 
This change can be specified on any of the following cards. 

The job card, 7/8/9 card (EOR mark), and 6/7/9 (EOF mark) can contain the keypunch 
conversion mode in columns 79 and 80. A 26 punched in columns 79 and 80 indicates that all 
subsequent cards are converted in 026 mode. A 29 indicates that subsequent cards are 
converted to 029 mode. Each conversion change remains in effect until another change card 
is encountered or the job ends. The user can switch between 026 and 029 mode as often as 
desired. If 26 or 29 does not appear in columns 79 and 80 of the job card, the initial 
keypunch mode of that job is the system default mode. If 26 or 29 does not appear on a 
7/8/9 or 6/7/9 card, no conversion change is made, and the most recent keypunch mode remains 
in effect. 

Keypunch mode can also be changed by a card containing a 5/7/9 punch in colmn 1. A blank 
(no punch) in colmn 2 indicates 026 conversion mode; a 9 punch in column 2 indicates 029 
mode. The conversion change remains in effect until another change card is encountered or 
the job ends. 


Literal Input 

The 5/7/9 card also allows literal input when 4/5/6/7/8/9 is punched in column 2. Literal 
input allows 80-coluiiin binary data to be read while transmitting input in coded mode. Cards 
are read (16 central memory words per card) until a card identical to the previous 5/7/9 
card (4/5/6/7/8/9 in column 2) is read. The next card can then specify the new conversion 
mode. 

In order to maintain system integrity, an end-of-information card always terminates 
80-column binary input (literal input). Either of the following is interpreted as an 
end-of-information card even though it appears in a literal input record. 

• A card with 6/7/8/9 punched in column 1 and with columns 2 through 80 blank. 

• A card with 6/7/8/9 punched in columns 1 and 80 and with columns 2 through 39 and 
columns 41 through 79 blank. Column 40 may be punched or left blank. 


tThese codes are ignored by a 200 User Terminal since conversion mode is selected by a 
hardware switch. (Refer to the Network Products Remote Batch Facility Reference Manual.) 
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FOR 63 AND 64 CHARACTER SETS 


• 80 CHARACTERS- 


-8 WORDS (80 CHARACTERS) ■ 


D C 


3 C 


3 C 


WORD 9 


60 BITS OF 
BINARY ZEROS 


±} 


-79 CHARACTERS- 


■ 7 WORDS (70 CHARACTERS)- 


r 


3 C 


3 C 


•j WORD 8 WORD 9 

1 1-11- 


9 CHARACTERS 


'' 60 BITS OF 

' BINARY ZEROS 


ONE BLANK IS RETAINED 
TO MAKE AN EVEN 
NUMBER OF CHARACTERS j 


U 


XI 


-56 CHARACTERS- 


-5 WORDS 150 CHARACTERS)- 


3 £ 


3 £ 


3 £ 


3 £ 


3L 


24 BITS 
I ZEROS 


33 


NO TRAILING BLANK 
IS RETAINED SINCE 
THERE IS AN EVEN 
NUMBER OF CHARACTERS 


; (00 IN DISPLAY CODE) 
-79 CHARACTERS-- 


FOR 64 CHARACTER SET ONLY 

■ U 7 WORDS (70 CHARACTERSI- 


3 £ 


3 £ 


3 £ 


3 £ 


-pj WORD 8 WORD 9 

□ J=3,J=XX 


9 CHARACTERS 


33 




12 CHARACTERS WITH 
: AS THE TWELFTH 


: 100)-J 

BLANK (55) ADDED ] 
TO SEPARATE : FROM, 
TRAILING ZEROS ) 


I 48 BITS OF 
I BINARY ZEROS 

I" • '~'"T 


a 




1 WORD 
10 CHAR, WORD 2 


EOL 

{ BLANK ADDED TO 
MAKE AN EVEN 
NUMBER OF 
CHARACTERS 


3 X 


3 


1 CHARACTER- 


iX| 


11 CHARACTERS WITH 
: AS THE ELEVENTH 
CHARACTER 


BLANK (55) ADDED 
TO SEPARATE : FROM 
TRAILING ZEROS 


- rrm 

TOI-ftt 

?omIJ L 


36 BITS 
1 OF BINARY 
I ZEROS 

- "m 


EOL 

BLANK ADDED TO 
MAKE AN EVEN NUMBER 
OF CHARACTERS 


1 WORD 
10 CHAR. 


WORD 2 


□ X 


I 48 BITS OF 
I BINARY ZEROS 


3J3 


EOL 

BLANK (55) ADDED 
TO SEPARATE : FROM 
TRAILING ZEROS 
THIS MAKES AN EVEN 
NUMBER OF CHARACTERS 


Figure F-1. Examples of Coded Card Conversion 
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BINARY CARDS 


Binary cards are denoted by a 7/9 punch in column 1 and can contain up to 15 central memory 
words. The 3447 card reader controller reads the binary data and passes it to the card 
reader driver in 12-bit codes. Each card column row corresponds to a bit position. The 
driver checks the checksum figure if this option is specified. The driver then passes the 
data to the central memory buffer. 


The fields within a 
Column(s) 


1 


2 

3 through 77 

78 

79 and 80 


binary card are: 

Description 

7/9 punch Indicates a binary card. 

4 punch ignores checksum punch in column 2. 

Rows 0, 1, 2, and 3 contain the binary equivalent of the word count 
of the card. 

Binary data checkstmt (modulo 4095). 

Fifteen central memory words of binary data. 

Blank. 

24-bit binary card sequence number. 


SUMMARY 

The following punches appearing in column 1 of a card have the corresponding meaning to the 
card reader driver. 


Punch 

Represents 


7/8/9 

End-of-record (optional conversion mode change) 

6/7/9 

End-of-file (optional conversion mode 

change). 

6/7/8/9 

End-of-informatlon. 


5/7/9 

Conversion mode change/read 80-column 

binary. 

7/9 

Binary card. 


Not 7 and 9 

Coded card. 



PUNCH RLE FORMATS 

Punched cards can be in three formats. 

• Coded (Hollerith punch) . 

• Binary. 

• Absolute binary. 
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The following conditions apply to all three formats. 

• When an EOR is encountered, a card is punched with a 7/8/9 in columns 1 and 80. 

This card is offset. 

• When an EOF is encountered for a file, a card is punched with a 6/7/9 in columns 1 
and 80; the remainder of the card is blank. This card is offset. 

• When an EOT is encountered on a file, a card is punched with a 6/7/8/9 in columns 1 
and 80; the remainder of the card is blank. This card is offset. 

• If a compare error is encountered, the erroneous card and the following card are 
offset. These two cards are repunched until no error is detected. An EOI card with 
6/7/8/9 punches in columns 1 and 80 contains a binary count in coliann 40 of the 
number of compare errors. 

• During the punching of each file, the system maintains a count of the number of 
cards punched for the file. If the number exceeds the limit for which the user is 
validated, punching of the file is terminated. A special banner card with the word 
LIMIT is punched and offset as the last card of the deck. 

The following methods are used by the system to punch each of the three forms of cards. 


CODED CARDS (PUNCH) 

With the exception of decks punched via the ROUTE command, the keypunch mode (026 or 029) of 
coded cards depends on the job origin type. If the job is of local batch origin, decks are 
punched in the initial keypunch mode (that is, the mode specified on the job card or set by 
system default). For all other job origin t)T>es, decks are punched in the system default 
keypunch mode. 


BINARY CARDS (PUNCH B) 

The card punch driver retrieves 15 words of binary data from central memory. The driver 
then generates a checksum for the data and issues a card number. The card punch controller 
receives the binary data and punches it on the card unchanged, that is, in 12-bit codes. 

Each row in a card column corresponds to a bit position. The driver formats the binary card 
in the following manner. 

Column(s) Contents 

1 7/9 punch denotes binary card. 

Rows 0, 1, 2, and 3 contain the binary equivalent of the word count 
of the card. 


2 


Binary data checksum (modulo 4095). 


3 through 77 Fifteen central memory words of binary data. 

78 Blank. 


79 and 80 


24-bit binary card sequence number. 
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ABSCHUTE BINARY CARDS (P8) 


Absolute binary cards are central memory Images in 12-bit codes, 
corresponds to a bit position. Sixteen central memory words are 
special punches or fields added. 


Each row in a card column 
punched per card with no 
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ANSI TAPE LABEL FORMATS 


G 


ANSI labels perform two functions. They provide information that uniquely identifies a flle- 
and the reel on which it resides, and they mark the BOI and EOI of a file and the beginning 
and end of a reel. 

ANSI labels are designed to conform to the American National Standard Magnetic Tape Labels 
for Information Interchange X3.27-1969. All labels are 80 characters long and are recorded 
at the same density as the data on the tape. The first three characters of an ANSI label 
identify the label type. The fourth character Indicates a number within a label type. 

Labels padded to longer than 80 characters and which otherwise meet the ANSI X3.27-1969 
standard are not processed by NOS as ANSI labels. Tapes with padded labels can be processed 
as unlabeled tapes by using the F, S, or L format (in this case, the label data is read or 
written by a user program). 

The following is a summary of each label type, name, function, and whether or not it is 
required. 


Type 

No 

Name 

Used As 

Required/Optio nal 

VOL 

1 

Voltnne header label 

Beginning-of-voliune 

Required 

UVL 

1-9 

User volume label 

Beginning-of-volume 

Optional 

HDR 

1 

File header label 

Beginning-of-information 

Required 

HDR 

2-9 

File header label 

Beginning-of-information 

Optional 

UHL 


User header label 

Beginning-of-informa tion 

Optional 

EOF 

1 

End-of-file label 

End-of-information 

Required 

EOF 

2-9 

End-of-file label 

End-of-information 

Optional 

UTL 

t 

User trailer label 

End-of-information 

Optional 

EOV 

1 

End-of-volume label 

End-of-volume 

Required when 
appropriate 

EOV 

2-9 

End-of-volume label 

End-of-volume 

Optional 


tAny member of the CDC 6-bit subset of the ASCII character set. 
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REQUIRED LABELS 


The VOLl, HDRl, and EOFl labels are required on all ANSI-labeled tapes. In addition, an 
EOVl label is required if the physical end-of-tape reflector is encountered before an EOFl 
label is written or if a multifile set is continued on another volume. In the descriptions 
of the contents of these labels, n is any numeric digit and a is any letter, digit, or any 
of the following special characters. 


NOTE 

The special characters are available only 
to programs doing internal label requests 
and/or writing their own labels. The 
characters are not available via the LABEL, 

REQUEST, or ASSIGN commands. 

Space ) < 

! * = 

" + > 

•> 

$ - @ 

% . [ 

& 

/ : 1 

( ; 

Some fields are optional. An optional field which does not contain the designated 
information must contain blanks. Fields which are not described as optional are required 
and written as specified, n-type fields are right-justified and zero-filled, and a-type 
fields are left-justified and blank-filled. 


VOL 1—VOLUME HEADER LABEL 

The volume header label must be the first label on a labeled tape. All reels begin with a 
VOLl label. If two or more reels belong to a volume set, the file section field in the 
following HDRl label gives the actual reel number. 


VOL 

1 

volume serial number 

va 

reserved 

reserved 

reserved 

owner 

identification 

owner identification (oid) 

oid 

reserved 

reserved 

reserved 

Isl 
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Character 

Position 

1-3 

4 

5-10 

II 


12-31 

32-37 

38-51 

52-79 

80 


Field Name 

Length 

(in Characters) 

Contents 

Default 

Checked on 

Read 

Checked on 
Overwrite 

Label 

identifier 

3 

Must be VOL. 


Yes 

No 

Label number 

1 

Must be 1. 


Yes 

No 

Volume serial 
number 

6 

Volume identification 
assigned by owner to 
identify this physical 
reel of tape. If the 
volume serial number 
is all blanks, the 
tape is a scratch tape. 

As read from 
existing label 

Yes, if Che 
file was 
assigned by 
volume serial 
number. 

No 

Accessibility 

(va) 

1 

An a character which 
indicates the restric¬ 
tions, if any, on 

Blank (un¬ 
limited access) 

No (refer to 
BLANK command. 

Yes 


who may have access 
to the information 
on the tape. A 
blank means un¬ 
limited access. 

Any other character 
means special 
handling, in the 
manner agreed 
between the inter¬ 
change parties. 
Refer to the 
BLANK command. 


Reserved for 
future standard¬ 
ization 

20 

Must be blanks. 


No 

No 

Reserved for 
future standard¬ 
ization 

6 

Must be blanks. 


No 

No 

Owner identi¬ 
fication (oid) 

14 

Any a characters 
identifying the 
owner of the physical 
volume. 

family 
name, user 

name 

Refer to dis¬ 
cussion of fa 
field of HDRl. 

Yes 

Reserved for 
future standard¬ 
ization 

28 

Must be blanks. 


No 

No 

Label standard 
level (Isl) 

I 

A 1 means the labels 
and data formats on 

1 

No 

No 


this volume conform 
to the requirements 
of the ANSI standard. 
A blank means the 
labels and data for¬ 
mats on this volume 
require the agreement 
of the interchange 
parties. 
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HDR1—FIRST RLE HEADER LABEL 


The first file header label must appear before each file. When a file is continued on more 
than one volume, the file header label is repeated after the volume header label on each new 
volume for that file. If two or more files are grouped in a multifile set, each HDRl label 
indicates the relative position of its associated file within the set. 


HDR 1 

file identifier (fi) 

file identifier (fi) 

fi 

set identification 

file section 
nimber (secno) 

secno 

file 

sequence number 

generation number 

gvn 

gvn 

creation date expiration date 

expiration 

date 

fa 

block count 

system code 

system code 

reserved 
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Character 

Position 

Field Name (in 

Length 

Characters) 

Contents 

Default 

Checked on 
Read 

Checked on 
Overwrite 

1-3 

Label 

identifier 

3 

Must be HDR. 


Yes 

No 

4 

Label number 

1 

Must be 1. 


Yes 

No 

5-21 

File identifier 
(fi) 

17 . 

Up to 17 a characc^ers 
used as the file iden¬ 
tification (ftleld) 
parameter on the 

LABEL command. 

Blank 

Checked if 
specified. 

No 

22-27 

Set identification 

6 

Up to six a characters 
used as the setid 
parameter on the 

LABEL command * To 
conform to the ANSI 
tape standard, this 
value is the same 
for all files of 
a multifile set* 

Blank; an 
appended file 
is given the 
same sec iden¬ 
tification as 
its preceding 
file. 

Checked if 
specified. 

No 

28-31 

File section 
number (secno) 

4 

Four n characters 
identifying Che file 
section number* 

0001 

Checked If 
specified. 

No 


The file section 
number of the first 
HDRl label of a file 
is 0001. If the file 
extends to more than 
one volume, this 
number is incre¬ 
mented by one for 
each subsequent 
volume. This value 
corresponds to the 
secno parameter on 
the LABEL command. 

32-35 File sequence 4 Four n characters used 0001 Checked if No 

number as the seqno parameter specified* 

on the LABEL command. 

This parameter specif- 
fies the position of 
a file within a file 
set* This value is 
0001 for the first file, 

0002 for the second, 
and so on. In all the 
labels for a given file, 
this field contains the 
same number* 
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Checked on 
Kead 


Overwrite 


Character 

Position 


36-39 


40-41 


42-47 


48-53 


Length Checked on 

Field Name (in Characters) Contents Default 


Generation 

4 

Four n characters 

0001 

Checked if 

number 


specifying the gen¬ 


specified. 

(optional) 


eration n\]mber of a 
file. This is Che 
genno parameter of 
the LABEL command. 

This value is 0001 
for the first genera¬ 
tion of a file, 0002 
for the second, and 





so on. 



Generation 

2 

Two n characters used 

00 

Yes 

version 


to distinguish suc¬ 



number (gm) 


cessive iterations 
of the same genera¬ 
tion. The generation 
version number of 
the first attempt to 
create a file is 00. 
This value corre¬ 
sponds to the gvn 
parameter of the 

LABEL command. 




No 


No 


Creation date 6 


Expiration date 6 


Date the file was Current date 

created; it is re¬ 
corded as a space 
followed by two n 
characters for the 
year followed by 
three n characters 
for the day within 
the year. This value 
corresponds to the 
cdate parameter of 
Che LABEL command. 

The file Is considered Current date 

expired when today's 

date is the same as or 

later than the date 

given in this field. 

When this condition is 
satisfied, Che remainder 
of the volume may be 
overwritten. Thus, to be 
effective on multifile 
volumes, the expiration 
date of a file must be 
earlier chan or the same 
as the expiration date of 


Yes. The crea- No 
cion date is 
meaningful only 
on read opera¬ 
tions; on write 
operations, the 
current date is 
always used. 


No 


Yes 
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Character 

P<ySition Field Name 


Length 

(in Characters) 


Checked on 
Read 


Checked on 
Overwrite 


54 Accessibility 

(fa) 


1 


55-60 Block count 6 

61-73 System code 13 


74-80 Reserved for 7 

future stan¬ 
dardization 


Contents Default 

all preceding files on 
the voluse. The ex¬ 
piration date is writ¬ 
ten in the same format 
as the creation date. 

It corresponds to the 
rdate parameter of the 
LABEL command. 


An a character which 

Blank (un¬ 

Yes, if a 

indicates the restric¬ 

limited access) 

NOS written 

tions » if any, on who 
may have access to 
the information in 
this file. A blank 


tape. 

means unlimit^ ac¬ 
cess. If fa is A, 
only the owner of 
the NOS written 
tape can access the 
file. If fa is any 
other character, all 
future accesses to 
the tape must specify 
this character as 
the fa parameter. 



File accessibility is 
not checked for sys¬ 
tem origin jobs. 



Must be zeros. 


No 

Thirteen characters 

NOS ver-est 

No 

identifying the op¬ 

(ver is the 


erating system that 

system version 


recorded this file. 

number and est 


The tape is con¬ 

is the EST ordi¬ 


sidered to have 

nal of the unit 


been written under 

on which the 


NOS if the first 10 

file was 


characters match the 
default. 

written). 


Must be spaces. 


No 


Yes 


No 

No 


No 
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iOFI—RRST END-OF-HLE LABEL 

The end-of-file label is the last block of every file. It is the system end-of-information 
for the file. A single tape mark precedes EOFl. A double tape mark written after the EOFl 
label marks the end of a multifile set. 


EOF 1 

file identifier (fi) 

file identifier (fi) 

fi 

set identification 

file section 
number (secno) 

secno 

file 

sequence number 

generation number 

gvn 

gvn 

creation date 

expiration date 

expiration 

date 

fa 

block count 

system code 

system code 

_ 

reserved 


Character 

Position 

1-3 


4 

5-5A 


55-60 


Length 

Field Name (in Characters) 

Label 3 

identifier 

Label number 1 

Same as corre- 50 

spending fields 
in HDRl (optional) 

Block count 6 


61-80 Same as corre- 20 

spending fields 
in HDRl (optional) 


Checked on 

Contents Default Read 


Must be EOF. 


Yes 


Must be 1. Yes 

Same as the corresponding Same as HDRl 

fields in HDRl. 


Six n characters specifying Yes 

the number of data blocks 
between this label and the 
preceding HDR label group. 

This total does not Include 
labels or tape marks. 

Same as corresponding fields Same as HDRl 

in HDRl. 
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EOVl—FIRST END-OF-VOLUME LABEL 


The end-of-volume label is required only if the physical end-of-tape reflector is 
encountered before an EOFl label is written or if a multifile set is continued on another 
volume. EOVl is preceded by a single tape mark and followed by a double tape mark. 


EOV 1 

file Identifier (fi) 

file identifier (fi) 

fi 

set identification 

file section 
number (secno) 

secno 

file 

sequence number 

generation number 

gvn 

gvn 

creation date 

expiration date 

expiration 

date 

fa 

block count 

system code 

system code reserved 


Character Length 

Position Field Name (In Characters) 


Contents 


Checked on 
Default Read 


1-3 Label 

Identifier 


3 Must be EOV. 


Yes 


4 

Label number 

1 

Must be 1. 

5-54 

Same as corre¬ 
sponding fields 

In HDRl (optional) 

50 

Same as the corresponding 
fields In HDRl. 

55-60 

Block count 

6 

Six n characters specifying 
the number of data blocks 
between this label and the 
preceding HDR label group. 
This total does not include 
labels or tape marks. 

61-80 

Same as corre¬ 
sponding fields 

In HDRl (optional) 

20 

Same as corresponding fields 
in HDRl. 


Yes 

Same as HDRl 


Yes 


Same as HDRl 
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OPTIONAL LABELS 

Six types of optional labels are allowed. They are additional file header (HDR2-9), 
end—of-file (EOF2-9), user volume (UVLa), header (UHLa), and trailer (UTLa) labels. 

HDR2 THROUGH HDR9—ADDITIONAL RLE HEADER UBELS t 


HDR2 through HDR9 labels may immediately follow HDRl. Their format is: 

Character Length Default 

Position Field Name (in Characters) Contents Written 


1-3 

Label 

identifier 

3 

HDR 

HDR 

4 

Label number 

1 

2-9 

2-9 

5-80 


76 



Only the label identifier and the label 

number are checked on 

read. 


EOF2 THROUGH EOF9 

—ADDITIONAL END-OF-RLE UBELS t 



E0F2 through E0F9 

labels may immediately 

follow EOFl. Their 

format is: 


Character 

Position 

Field Name 

Leng th 

(in Characters) 

Contents 

Default 

Written 

1-3 

Label 

identifier 

3 

EOF 

EOF 

4 

Label number 

1 

2-9 

2-9 

5-80 


76 



Only the label identifier and the label 

number are checked on 

read. 


EOV2 THI^OUGH EOV9—ADDITIONAL END-OF-VOLUME LABELS t 



EOV2 through E0V9 

labels may immediately 

follow EOVl. Their 

format is: 


Character 

Position 

Field Name 

Leng th 

(in Characters) 

Contents 

Default 

Written 

1-3 

Label 

identifier 

3 

EOV 

EOV 

4 

Label number 

1 

2-9 

2-9 

5-80 


76 




tThese are reserved for operating system use. Attempts by user programs to generate them 
will produce undefined results. 
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Refer to section 3 in Volume 4, Program Interface, for a description of the use of E0V2 
labels in conjunction with CLOSER, REWIND, and UNLOAD macros. 


USER LABELS 


User labels may immediately follow their associated system labels. Thus, user volume labels 
(UVLa) may follow VOLl, user header labels (DHLa) may follow the last HDRn label, and user 
trailer labels (UTLa) may follow the last EOVn or EOFn label. Their format is: 


Character 

Position 

Field Name 

Length 

(in Characters) 

Contents 

Default 

Written 

1-3 

Label 

3 

UVL, UHL, or UTL. 

UVL, UHL. 

4 

identifier 

Label number 

1 

Must be 1, 2, 3, 4, 

or UTL. 

5-80 

User option 

76 

and so on, consec¬ 
utively for UVL labels 
For other labels, any 
a character. 

Any a characters. 

• 

Only the label 

identifier and the 

label number are 

checked on read. The system 

checks the 

number of user 

labels of a label 

type; a maximum of 

64 is allowed. 
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LINE PRINTER CARRIAGE CONTROL 


H 


Appendix H provides information required to prepare files for printing,t The information 
includes the following: 

• NOS-supported paper lengths. 

• Carriage control characters. 

• Punched tape channel formats (non-PFC printers only). 

• PFC, EVFU, and VFU arrays. 

For the 5870 Non-Impact Printer, applicable information in this section is contained under 
Printed Data below and in table H-1. Note that the Q, R, S, T, and V carriage control 
characters are not supported by the 5870 printer. If encountered in a print file, these 
characters are ignored. 

Default characteristics for the 5870 printer, such as the print font, page length, and print 
density are determined by the site. Check with your site administration for this 
information. 

For further information on the functional characteristics of the 5870 printer, refer to the 
5870 Site Reference Manual. 


PRINTED DATA 

All data to be printed is in coded format in a file within the print queue. The data 
consists of either 6-bit or 12-bit codes. Data recorded using the 6/12-bit display code set 
(refer to appendix A) should be converted to the 7-bit ASCII code set (refer to the FCOPY 
command in section 9) before being routed to a line printer. 

The system extracts data until an end-of—line occurs or until 137 characters are retrieved. 
End—of—line is 12 or more zero bits in the rightmost byte of a central memory word. 


PAPER LENGTH 


580 LINE PRINTERS 

NOS supports two paper lengths for 580 line printers, standard (14 inches x 11 inches) and 
short (14 inches x 8 1/2 inches). Files routed to a line printer must be properly formatted 
for the paper length used on the specified printer. 


t 


The information in this appendix does not 


apply to remote batch line printers. 
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When printing on standard paper size, you have the option of specifying a print density of 
either 6 or 8 lines per inch. At 6 lines per inch, a maximum of 64 lines per page can be 
printed on standard paper. At 8 lines per inch, a maximum of 84 lines per page can be 
printed on standard paper. 

All output printed on short paper is printed at a density of eight lines per inch. The 
carriage control characters used to specify print density (S and T) are ignored. A maximum 
of 66 lines can be printed on one page of short paper; overflow lines, if any, are printed 
on the following page. 

A system default print density is used if you do not specify one for your print file. The 
system default is site selectable using the SPD IPRBECK entry; refer to NOS 2 Analysis 
Handbook for more information on SPD IPRDECK entry. 


533/536, 537, AND 585 PRINTERS 

The 533/536, 537, and 585 printers are supported by the Printer Support Utility (PSU). 

These printers can accommodate 8 1/2-, 11-, and 12-inch paper sizes. Modifying the EVFU 
load file (for 533/536 printers) or the VFU load procedure (for 585 printers) enables these 
printers to use other paper sizes. Refer to the NOS 2 Analysis Handbook for more 
information on PSU, and the EVFU load file. Refer to the CDCNET Network Configuration and 
Site Administration Guide for more information on the VFU load procedure. The 537 printers 
can use various paper sizes, as determined by settings on the printer. Refer to the NOS 2 
Operations Handbook for more information on settings for 537 printers. 

Unlike the 580 printers, the 533/536 and 585 printers support both six and eight lines per 
inch print densities for short paper output, as specified by the S and T carriage control 
characters. Vertical print density for 537 printers is determined by a switch setting on 
the printer. Refer to the NOS 2 Operations Handbook for more information on switch settings 
for 537 printers. 


CARRIAGE CONTROL 

You can control the format of printer output using the carriage control characters listed in 
table H-1 and table H-2. The system interprets the first character in a line as the 
carriage control character and that character is not printed.! The remainder of the line 
is then printed, except when a Q, R, S, T, or V carriage control character is specified. 

The Q, R, S, T, and V format controls remain in effect until changed; all other carriage 
control characters must be supplied for each line they control. 

Line spacing is normally done in auto eject mode; that is, creases in the paper are skipped 
by the line printer's automatic line spacing mechanism if the paper is loaded properly. 

Auto eject mode must be turned off if you want to select format channels to advance printing 
from a position above the bottom of form to a position beyond the next top of form. 


TTo print a file in which the first character of each line is not a carriage control 
character, refer to the COPYSBF command in section 9. 
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The 585 printers support all carriage control characters. The 533/536, 537 printers support 
all carriage control characters except V. Note that a page eject is issued to the 533/536, 
537, and 585 printers whenever the print density is changed or when auto page eject is 
either set or cleared. Also, for 533/536 printers, auto page eject is set to ON whenever 
the print density is changed. 

The 537 printers defined as printer class C537INT support carriage control characters 1, 0, 
-,+,/, and space. Lines with carriage control characters Q, R, S, and T are suppressed. 

control character 3 is treated the same as a I; that is, a page feed is performed 
before printing. A V causes a page feed, but without printing. All other characters in the 
carriage control position are translated to a space. 

The 537 printers defined as printer class C537BAT support carriage control characters 1, 0, 

“, +, /, A, and space. Period, comma, and characters in the range 0 through 2A (16) result 
in skipping one line before printing. All other characters cause the line not to be printed. 

The system limits the number of lines you can print from a given file (refer to the LIMITS 
command). Your site can further limit the number of lines you can print by establishing a 
minimum number of lines per page for which you will be charged. During the printing of each 
file, the system maintains a count of the number of lines printed or skipped for the file. 

If the number exceeds the limit for which you are validated, printing of the file is 
terminated. The informative diagnostic LINE LIMIT EXCEEDED is printed. If a job's dayfile 
is part of the terminated file, the dayfile is subsequently printed. 
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Table H-1. Carriage Control Characters for 512/580 and 5870 Printers 


Character 

512/580 

Line 

Charge 

5870 

Line 

Charge 

Action 

space 

1 

1 

Single space. 

1 

Page 

Size 

1 

Eject page before printing. 

0 

2 


Skip one line before printing (double space). 

- 

3 


Skip two lines before printing (triple space). 

+ 

1 


Suppress carriage advance before printing (overprint). 

/ 

1 


Suppress carriage advance after printing (overprint). 

2 

Page 

Size/2t 

IH 

Skip to last line of form (format channel 12) before printing. 


1 

H 

Priiit the rest of the line. Then stop the printer and issue 
a flashing message to the operator console to indicate a change 
forms request or other operating instructions. 

Q 

0 

0 

Clear auto eject.tt Remainder of line is not printed. 

R 

0 

0 

Set auto eject. Remainder of line is not printed.ttttt 

Sttt 

0 

0 

Print 6 lines per inch* Remainder of line is not printed 

Tttt 

0 

0 

Print 8 lines per inch* Remainder of line is not printed • tTtl’t 

V 

Page 

Sizet 

0 

Eject page before printing on a 580 PFC printer. Loads a 
user-specified PFC array .tttt ttttt 

8 

1 

1 

Skip to top of page (format channel 1) before printing. 

7 

2 

1 

Skip two lines (format channel 2) before printing. 

6 

2 

1 

Skip three lines (format channel 3) before printing. 

5 

3 

1 

Skip four lines (format channel 4) before printing. 

4 

3 

1 

Skip five lines (format channel 5) before printing. 

3 

4 

1 

Skip one page (format channel 6) before printing. 

H 

1 

1 

Skip to top of page (format channel 1) after printing. 

G 

2 

1 

Skip two lines (format channel 2) after printing. 

F 

2 

1 

Skip three lines (format channel 3) after printing. 

E 

3 

1 

Skip four lines (format channel 4) after printing. 

D 

3 

1 

Skip five lines (format channel 5) after printing. 

C 

4 

1 

Skip one page (format channel 6) after printing. 


tPage size is 64 lines per page if 6 lines per inch is selected or page size is 85 
lines per page if 8 lines per inch selected. 
ttWhen printing at 8 lines per inch, a Q carriage control character also causes a 580 
printer to revert to 6 lines per inch (except when short paper is used). 
tttNo line feed after printing. For all other control characters, a line feed is 

issued after printing. The S and T control characters are Ignored when short paper 
is specified. Short paper output is printed at 8 lines per inch. 
ttttYou must be properly validated to use the V carriage control character. 
ttfttNot supported by the 5870 Non-Impact Printer. 
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Table H-2. Carriage Control Characters for 585 Printers (Sheet 1 of 2) 


Character 

585 

Line Charge 

Action 

Space 

1 

Single space. 

1 

t 

Eject page before printing. 

0 

2 

Skip one line before printing. 

- 

3 

Skip two lines before printing. 

+ 

0 

Suppress carriage return before printing (overprint). 

/ 

0 

Suppress carriage return after printing (overprint). 

2 

tt 

Skip to last line of form before printing. 

PM 

0 

Stop printer and display the rest of the line at the operator 
console; used to issue a change forms request or other 
instructions to the operator. 

Q 

ttt 

Clear auto eject; remainder of line is not printed.tttt 

R 

ttt 

Set auto eject; remainder of line is not printed.tttt 

S 

ttt 

Print 6 lines per inch; remainder of line is not printed.tttt 

T 

ttt 

Print 8 lines per inch; remainder of line is not printed.tttt 

V 

ttt 

Eject page before printing; loads a user specified vertical 
format unit (VF'u).tttt 

8 

t 

Skip to top of page (format channel 1) before printing. 

7 

2 

Skip two lines (format channel 2) before printing. 

6 

3 

Skip three lines] (format channel 3) before printing. 

5 

4 

Skip four lines (format channel 4) before printing. 

4 

5 

Skip five lines (format channel 5) before printing. 

3 

6 

Skip six lines (format channel 6) before printing. 

9 

7 

Skip to format channel 7 before printing. 

X 

8 

Skip to format channel 8 before printing. 

•Y 

9 

Skip to format channel 9 before printing. 

Z 

10 

Skip to format channel 10 before printing. 

tNumber of lines remaining on the page. Page size is 66 if 6 lines per inch is selected 
and 88 if 8 lines per inch is selected. 

Number of lines remaining on the page minus 2. If the number of lines remaining on the 
page is less than 2, count page size. 

tit Number of lines according to required paper movement: 0 if format effector is ignored 
or discarded; 1 if line is printed with single spacing; number of lines remaining if a 
VFU load with page eject is required. 

tilt Causes page eject when action is complete. Unsupported control characters are 

discarded. Lines containing control characters redefining an existing condition are 
processed with the unsupported format effector action specified by your site. 
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Table H-2. Carriage Control Characters for 585 Printers (Sheet 2 of 2) 


Character 

585 

Line Charge 

Action 

W 

t 

Skip to format channel 11 before printing. 

U 

12 

Skip to format channel 12 before printing. 

A 

t 

Eject page after printing. 

B 

tt 

Skip to last line of form after printing. 

H 

t 

Skip to top of page (format channel 1) after printing. 

G 

2 

Skip two lines (format channel 2) after printing. 

F 

3 

Skip three lines (format channel 3) after printing. 

E 

4 

Skip four lines (format channel 4) after printing. 

D 

5 

Skip five lines (format channel 5) after printing. 

C 

6 

Skip six lines (format channel 6) after printing. 

I 

7 

Skip to format channel 7 after printing. 

J 

8 

Skip to format channel 8 after printing. 

K 

9 

Skip to format channel 9 after printing. 

L 

10 

Skip to format channel 10 after printing. 

M 

t 

Skip to format channel 11 after printing. 

N 

12 

Skip to format channel 12 after printing. 

t Number of lines remaining on the page. For example, for a forms length of 11 inches, 

page size is 66 if 6 lines per inch is selected and 88 if 8 lines per inch is selected. 

tt Number of lines remaining on the page minus 2. If the number of lines remaining on the 

page is 

less than 2, count page size. 
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FORMAT CHANNEL SELECTION ON NON-PFC PRINTERS 

Non-PFC line printers, other than 533/536, 537, and 585 printers, use a punched tape loop to 
control carriage advancement. Figure H-1 shows the released tape format for printers using 
the standard paper size at 6 lines per inch. Figure H-2 shows the tape format for short 
paper printers. 

The format tape shown in figure H-1 can be ordered as customer engineer's part number 
44682683. 

Each line, or frame, in the tape format represents one line of printer output. Notice, in 
figure H-1, that frames 132 through 134 are identical to frames 0 through 2. To form a 
continuous loop, the ends of the tape are fastened together with the first three frames (0 
through 2) superimposed over the last three frames (132 through 134). This leaves a tape 
loop consisting of 131 frames. The tape format in figure H-1 represents two pages of 
64-line printer output. The blank lines at frames 64 and 65, and at frames 130 and 131, 
represent spaces for the creases between pages. 

Each channel controls a specific carriage control operation. Channel 1, for example, 
provides for top of page spacing, channel 3 controls triple spacing of lines, and channel 12 
spaces to the bottom of the page. 

For postprint operations, when the carriage control character in column 1 of a print line 
specifies a channel number, the printer checks that format channel, in the current frame, 
for a punch. If a punch is found, the printer prints the line. If no punch is found, the 
printer advances the punched tape loop (and, at the same time, the printer carriage) until a 
punch is found in that channel in a subsequent frame. At that point, the printer prints the 
line. 

As an example of format channel usage, assume that the printer carriage is positioned at the 
second line of a page (frame 1 of the format tape). Also assume that the second output line 
contains a carriage control character of 2. The printer checks frame 1 and finds no punch 
in channel 12, so it advances to the next frame containing a punch in channel 12. The next 
punch occurs in frame 63 (line 64); therefore, the second output line is printed as the last 
line on the page. 


FORMAT CHANNEL SELECTION ON 533/536, 537, AND 585 PRINTERS 

Format channel selection for 533/536 and 585 printers is defined by the EVFU load file and 
the VFU load procedure respectively. Refer to the NOS 2 Analysis Handbook for a description 
of the EVFU load file. Refer to the CDCNET Network Configuration and Site Administration 
Guide for a description of the VFU load procedure. Format channel selection for 537 printers 
is not supported at level 688. 
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Figure H-1. Carriage Control Tape Format (Standard Paper Length; 6LPI) 
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Figure H-2. Carriage Control Tape Format (Short Paper Length; 8 LPI) 
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CARRIAGE CONTROL ARRAYS 


Line spacing on a printer is controlled by a carriage control array. This array has the 
following forms for the various printers: 

• Programmable format control (PFC) array for 580 printers. 

• Carriage control tape for non-PFC 580 printers. 

• Electronic vertical format unit (EVFU) for 533/536 printers. 

• Vertical format unit (VFU) for 585 printers. 

The selection of an array for any printer is dependent on the print density and the paper 
length to be used. You can specify one of several arrays already defined by the system 
using the SC parameter on the ROUTE command. These arrays are described in the NOS 2 
Analysis Handbook. You can also select a user-specified PFC or VFU array to control print 
spacing. You must have validation to use a user-specified PFC array (refer to the LIMITS 
command). A user-specified array remains in effect until another array is encountered or 
the end-of-file is reached. The print density for printers using standard sized paper is 
selected using the S or T carriage control characters. 580 printers using short paper 
always use a print density of 8 lines per inch and ignore S and T. 

A user-specified array begins with the control character V. When a V is encountered, the 
printer ejects the page. For non-PFC 580 printers, the rest of the line is ignored. For 
PFC 580 printers, if your are not validated to use the V carriage control character, the 
print operation aborts and you receive an appropriate message in your output file. 


ARRAY SYNTAX 

An array consists of a string of alphanumeric characters that can be used to redefine some 
or all of the format channels of the previously specified array. An array for output at 6 
lines per inch occupies one line of up to 132 characters plus the terminator for 580 
printers, up to 127 characters for 585 printers. An array for 8 lines per inch may occupy 
one or two lines. For printing on standard length paper, an array for 8 lines per inch can 
consist of up to 176 characters on 580 printers, 127 characters on 585 printers (88 lines 
per page). For short paper printers, an array for 8 lines per inch must not exceed 136 
characters plus the terminator for 580 printers, 127 characters for 585 printers (68 lines 
per page). 

Column 1 of an array must contain the carriage control character V. The second character of 
the array determines which array is changed and may be one of the following values. 

Value Description 


6 lines per inch; the entire array specification occupies one line. 

8 lines per inch; the entire array specification occupies one line. 

8 lines per inch; the array specification continues onto a second 
line. The second line begins in column 3; columns 1 and 2 of the 
second line are ignored. 
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The array must be terminated by the letter 0. Starting in column 3 and continuing up to the 
column that precedes the array terminator (letter 0), each column in the array represents 
one line of printer output. A format channel indicator placed in one of these columns in a 
user-specified array changes the format channel in effect for the corresponding output 
line. If an array column is left blank, the format channel for the corresponding line 
remains unchanged. The channel indicators that can be inserted in these columns are as 
follows. 


Character Significance 

A Specifies top of form code (channel 1); mandatory entiry in column 3 

of the array (representing output line 1). Delete previous 
channels. 


B through L 

M 

N 

0 


Specify format channels 2 through 12, respectively. Delete 
previous channels. 

Specifies auto page eject channel. Applies to 585 printers only. 
Specifies bottom of form channel. Applies to 585 printers only. 
Array terminator. 


X Remove the channel format previously in effect for the line. 

Applies to 585 printers only. 

Blank No channel is specified; the channel format previously in effect 

for the line remains unchanged. 


In the 580, each channel number referenced in your PFC array must appear in the PFC array 
previously in effect. Channel specifications can be repeated within an array. 


Notes 


If a PFC array contains an invalid 
character, the array line is printed, and 
the printing of the file is terminated. 

Other arrays with invalid characters are 
ignored, and the file is printed using the 
carriage control array previously loaded 
into the printer. 

If a VFU array contains an invalid 
character, the line containing the V control 
character is processed according to the 
undefined format effector action. 
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Following are some examples of invalid array specifications: 


Invalid Array 
V6BCD 0 
VBA C DEO 
V8ABWC0 
V6A 0 


Error 

Does not contain an A in column 3. 
Second character is not 6, 8, or C. 
Contains an invalid character (W). 
Contains a zero for the terminator. 


RESERVED FORMAT CHANNELS FOR VFU PROCESSING 

For printers that support format channels, three channels are reserved for specific carriage 
control operations. Channel 1 is always used to position the paper to the top-of-form. Two 
additional site selected channels are also reserved: one for positioning the paper to the 
logical bottom-of-form, and one for skipping over the perforations between forms (auto page 
eject). Each of these channels may appear only once in a VFU array. By default, both the 
bottom-of-form and auto-page-eject channels will be placed two lines above the physical end 
of the form. If the operator or user changes form size or print density, the bottom-of-form 
and auto—page-eject channels are moved to accomodate the change in the number of lines on 
the form. If the auto-page-eject option is changed, then the auto-page-eject channel is 
removed and restored in the VFU array. 


EXAMPLE 

The following is an example of an array used to print a special 8-line form. 

Suppose you want to print on the top, fifth, and bottom lines of an 8-line form (at 8 lines 
per inch print density). Load the following array: 

Columns: 1 2 3 4 5 6 7 8 9101112 

V 8 A BN 0 

Since columns 4, 5, 6, 8, 10, and 11 are blank, the format channels for these columns remain 
unchanged from the array previously in effect. You might want to put an X or a dummy 
channel indicator (that is, a valid channel indicator that is not otherwise referenced in 
the file), such as a K, into these columns to ensure that the B and N channel indicators 
appear only where intended. 

After loading the example array above, output lines beginning with an 8 or H (format channel 
1) are printed at the top of the form, lines beginning with a 7 or G (format channel 2) are 
printed at the fifth line, and lines beginning with a 2 (bottom-of-form channel) are printed 
at the bottom of the form. 
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OBSOLETE TAPE FORMATS 


I 


The B, E, and X format coded tapes are no longer supported by NOS. The following 
description of the physical and logical characteristics of the obsolete tapes is included as 
a reference for 3^0 u if you use the TCOPY ccamnand. 


B (BLOCKED) FORMAT 

Characteristics 


Description 


Header 

Mode 

Block size (PRO size) 


Logical end-of-record 


Logical end-of-file 
Logical end-of-informatlon 
End-of-reel 

Noise 

Special considerations 


Unlabeled. 

Coded. 

The block size cannot exceed 5120 frames. If the 
tape unit will not allow an odd number of frames to 
be written, the system will append a space. Unless 
you specify otherwise when you request a tape, the 
system will assume the maximum block size is 150 
frames. 

For a write operation, there is no logical 
end-of-record. For a read operation, end-of-record 
status is returned when a tape mark is encountered. 
An additional read operation returns end-of-file 
status. 

Tape mark. 

None. 

Refer to option 2 under End-Of-Tape/End-Of-Reel 
Conditions. 

Any block containing fewer than 18 frames is 
considered noise, and is, therefore, ignored. 


• B-formatted tapes cannot be labeled. 

• A write operation will stop either at a zero byte (end-of-line) in byte 4 of a 
CM word or at a multiple of CM words (rounded up) based on the frame or 
character count. 

• For control word reads, byte count and unused bit count will be set 
appropriately. For regular reads, EOL is guaranteed. 

• For a control word write operation, no end-of-line processing is done. Data is 
blocked on tape using the specified frame count. Likewise for a control word 
read operation, no end-of-line processing is done; data is transferred to you 
as it is read. 
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Description 


E (LINE IMAGE) FORMAT 

Characteristics 


Header 

Mode 

Block size (PRU size) 


Logical end-of-record 


Logical end-of-file 
Logical end-of-information 
End-of-reel 

Noise 

Special considerations 


Unlabeled. 

Coded. 

The block size cannot exceed 5120 frames. If the 
tape tmit will not allow an odd number of frames to 
be written, the system will append a space. Unless 
you specify otherwise xAien you request the tape, the 
system assumes the maximum block size is 136 frames. 

For a write operation, there is no logical 
end-of-record. For a read operation, end-of-record 
status is returned when a tape mark is encountered. 
An additional read operation returns end-of-file 
status. 

Tape mark. 

None. 

Refer to option 2 under End-Of-Tape/End-Of-Reel 
Conditions. 

Same as for B-formatted tapes. 


• E-formatted tapes cannot be labeled. 

• For a write operation, a block of data will stop either at a zero byte 
(end-of-line) in byte 4 of a CM word or at the multiple of CM words (rounded 
up) based on the frame or character count. The system will then space-fill the 
buffer to the number of frames specified. Thus, the amount of data written 
will exactly equal the amount specified. 

• For a read operation, if there is an odd ntimber of characters, the system will 
space—fill the last 6 bits of the last byte and delete all trailing spaces. 

For control word reads, byte count and unused bit count will be set 
appropriately. For regular reads, EOL is guaranteed. 

• For a control word write operation, no end-of-line processing is done. Data is 
blocked on tape using the specified frame count. Likewise for a control word 
read operation, no end-of-line processing is done; data is transferred to you 
as it is read. 
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Description 


X (EXTERNAL) FORMAT 

Charac terIstics 

Header Dnlabeled. 


Hode 


Binary. 


Block size (FRU size) 


Logical end- 0 £-record 


Log ical end-o f- f ile 


Actual data block size can range from 0 to 512 
(lOOOg) CM words in exact multiples of CM words. 

Any block containing fewer than 512 CM words 
represents a logical end-of-record. If a logical 
record consists of an exact multiple of 512 words, 
the block that denotes the logical end-of-record 
consists solely of a 48-bit block terminator. 

Tape mark. 


Logical end-of-information None. 


End-of-reel 


Refer to option 1 under End-Of-Tape/End-Of-Reel 
Conditlons. 


Noise Any block containing fewer than eight frames for 

seven-track tapes or six frames for nine-track tapes 
is considered noise, and is, therefore, ignored. 

Special considerations 


• X-formatted tapes cannot be labeled. 

• All nine-track tapes are written in an even multiple of bytes. 


END-OF-TAPE/END-OF-REEL CONDITIONS 

The following is a description of the processing options for end-of-tape conditions. You 
can select one of these options by default by specifying the data format or you can specify 
an option via the PO keyword on a LABEL, ASSI®, or REqOEST command. 

Option PO* Option Description 


Rewrites the block on which the end-of-tape condition is 
sensed as the first block on the next volume, if the 
system senses the EOT during a write operation. During a 
read operation, the block on which the EOT occurred is 
ignored and reading continues on the next volune. If a 
tape mark and the EOT are sensed at the same time, the EOT 
is Ignored. 
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Option 


P0= Option 


Description 


2 P Writes a trailer sequence following the block on which the 

EOT is sensed, if the system senses the EOT during a write 
operation. Any data that occurs following the block on 
which EOT is sensed, yet before the tape mark, is 
ignored. During a read operation, the system transfers 
the block on which the EOT is sensed to your job. The 
read operation resunes on the next reel. If a tape mark 
and the EOT are sensed at the same time, the EOT is 
ignored. 

The system is concerned only with the block on vAich the EOT is sensed. If tapes written 
using these options are transferred to another system, any data that occurs on the reel 
after this block should be ignored. 
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NAM/CCP TERMINAL DEFINITION COMMANDS 


INTRODUCTION 

The NAM/CCP network, through which terminals access a host and its applications (like lAF), 
can support many types of terminals. All supported terminals are grouped by the network 
into 18 standard terminal classes. Each terminal class has specific operating 
characteristics, also referred to as terminal characteristics. These terminal 
characteristics, taken together, make up a terminal definition and are predefined by the 
network to closely match the operating characteristics of actual terminals. The network 
accepts changes to any of these terminal definitions through terminal definition commands. 
These commands specify one or more parameters, each of which may give a new value to a 
terminal characteristic. Tables J-1 and J-2 list these terminal definitions, the default 
values, and possible values for each of the 18 classes. 

The tables use the following abbreviations when identifying the terminal types for each 
terminal class: 

Abbreviation Terminal 

HASP Terminals using the Houston Automatic Spooling Program 

communication protocol, 

HAZ Hazeltine. 

POST HASP terminals that only support postprint format control. 

PRE HASP terminals that only support preprint format control. 

Tek Tektronix (teletypewriter emulation). 

TTY Teletype. 

UT User Terminal. 

X.25 Terminals connected to a packet switching network (PSN) using the 

X.25 communication protocol, 

X3.64 Terminals conforming to the ANSI X3.64 standard. 

When a terminal logs in to the network, either the network assumes it to be of a certain 
terminal class or assigns it a terminal class that resembles the terminal's actual 
characteristics. If you do not know the terminal class in use, you can enter the CH command 
(described in this appendix) to ascertain the terminal class and some of the characteristics 
of your terminal. In either case, if the characteristics of your terminal do not match 
those of its assigned terminal class, you can change the values of the terminal 
characteristics or even change the terminal class by using the terminal definition commands 
described in this appendix. You can enter terminal definition commands any time the 
terminal is connected to the network (refer to login/logout procedures in Volume 1, 
Introduction to Interactive Usage). 
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Vfhen you tise a terminal definition command to change a value, that change remains in effect 
until tte terminal is disconnected from the network or another terminal definition command 
is used to change the value. Even application switching and logout do not change the values 
of the terminal characteristics if the terminal has not been disconnected from the network. 
Disconnecting your terminal from the network (that is, disconnecting the phone and redialing 
on dial-up terminals or turning a dedicated terminal off and then on again) causes all 
terminal characteristics to be reset to site-defined default values. The site defines these 
values using the Network Definition Language (NDL). 

You can also reset your terminal's characteristics by entering the TC command. The TC 
commaixi resets your terminal characteristics to the default values specified by the 
Communications Control Program (CCP). Note that CCP-defined values may differ from the 
site-defined NDL values. 

It is also possible to change terminal definitions using the TRMDEF command or by using 
control byte 16 from an interactive job. Section 8 describes the TRKDEF command under 
Terminal Definition Commands. Refer to Volume 4, Program Interface, for information on 
control bytes. 


J-2 
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TERMINAL DEFINITION COMMAND FORMAT 

This section describes the general format of a terminal definition command. The specific 
format of each command appears later in this appendix. 

General formats: 


ct keyword=valuet 

ct keywordi=valuei ct keyword 2 =value 2 ...ct keywordn=valuen 

Parameter Description 

Represents the network control character for your terminal as defined by 
the CT terminal definition command. Table J—1 gives the default network 
control character for your terminal.tt 

keyword Represents a mnemonic associated with a terminal characteristic. 


Specifies a particular value associated with the terminal definition 
mnemonic. Table J-2 gives the range of values for each terminal 
definition keyword. On some commands the =value portion of the command 
is optional and defaults to =Y. 


keyword^ Same as keyword, 

value^ Same as value. 


The second format allows you to make multiple terminal definitions in one line. If the line 
extends beyond character position 54, the results are unpredictable. Also, if you change 
the network control character ct in a concatenated group of commands, the CT command does 
not take effect until the remaining commands in the group have been processed. 


As with all commands described in this manual, you must press the message transmission key 
in order for the system to process your command. Appendix K shows the default message 
transmission keys for the various terminal classes. This appendix describes how you can 
change the message transmission key (refer to the EB and EL commands). 


Example: 


To change the page width of a 200 User Terminal, enter these characters 
%PW=50 


and press the SEND key. The % character is the network control character, PW is the keyword 
associated with page width, 50 is the new page width for the terminal, and the SEND key is 
the message transmission key for a 200 User Terminal. 


tThe spaces shown are for clarity only. Do not include spaces when you enter a terminal 
definition command. 

ttYou must press the ATTN key on a 2741-compatible terminal before entering this character. 
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RESTRICTIONS 


You should not enter terminal definition commands while output is in progress. The network 
may not be able to perform such commands immediately. 

The network presets all user-adjustable terminal characteristics any time you establish a 
connection to the network. The site administrators choose these preset values. 

■^'^ibionally, when a terminal is disconnected from the network and then reconnected, the 
network resets any terminal characteristics you have changed to their preset values. 

To enter a terminal definition command at asynchronous terminals from which you can enter 
more than one line before transmitting (IN=BK is specified), the terminal definition command 
must be the last input line in the transmission. If the input is from paper tape (IN=PT is 
specified), the tape reader must stop. Unpredictable results can occur if more input 
follows the terminal definition command in the transmission block. 

Characters or character codes you specify for the value portion of terminal definition 
commands are subject to the following restrictions: 

• You cannot use the following ASCII characters (or their character codes) in the 
value portion of the AB, CN, BS, Bl, B2, CT, EB, or EL commands; 

any lowercase or uppercase alphabetic character 

any digit 0 through 9 

NUL 

SOH 

STX 

DEL 

space 

• The ASCII characters or character codes you specify for the AB, BS, Bl, B2, CN, CT, 
EB, and EL terminal definitions must all be different, except that AB and CN can 
have the same value and EB and EL may have the same value. 

• If output flow control is used, do not use DCls and DC3s in the AB, CN, BS, Bl, B2, 
CT, EB, or EL commands. 


TERMINAL DEFINITION COMMANDS 

This subsection describes the function and format of each terminal definition command. The 
headings consist of the command name (a two—character mnemonic) followed by the terminal 
attribute it defines. Generally, the format descriptions do not show the default values or 
ranges of values since they vary with terminal class. Tables J-1 and J-2 show this 
Information. If you are unable to find the key on your keyboard that corresponds to a 
particular character given in table J—1, consult the docimientatlon for your terminal. 

This section refers to categories of terminal classes to which commands apply. The 
categories are as follows: 


Category 

Asynchronous 
Mode 4 
HASP 

Bisynchronous 
X.25 PSN 
3270 


Terminal Classes 

1 through 8 
10, 11, 12, 13, 15 
9, 14 
16, 17 

1, 2, 3, 5, 6, 7, 8 
18 
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(AB) - ABORT OUTPUT BLOCK CHARACTER 


The AB connnand specifies the character used to abort an output block. When you enter this 
character from the terminal as the only character in a line, the current transmission block 
of output to the terminal is discarded. 

Format: 

ct AB=ab 

Parameter Description 

ct Represents the network control character for your terminal as defined by 

the CT terminal definition command. 

ah Specifies the new abort output block character. This character must 

differ from the characters defined for BS, B1, B2, CT, EB, and EL. 

This command only applies to asynchronous terminals and is not valid for X.25 PSN terminals. 


(AR) • AUTOMATIC CHARAaER RECOGNITION 

The AR command allows you to change the terminal's character set or its line speed, in many 
cases, by means of a switch on the terminal or a removable type ball. You can enter this 
command any time after the system prompts you for input, even before you enter your user 
name during login. 

Format; 

ct AR 

Parameter Description 


ct Represents the network control character for your terminal as defined by 

the CT terminal definition command. 

After entering the AR command, you must select the terminal speed and enter a carriage 
return. The system acknowledges the carriage return operation and Indicates that the line 
speed recognition is complete by returning two line feeds. If your terminal cannot change 
its line speed, no line feed responses occur. At this point, enter a closing parenthesis 
followed by a carriage return so that the system can recognize the terminal's new character 
set. When the system recognizes the new character set, it issues a line feed and the 
message AR ACCEPTED.. to indicate you can continue. This is also the auto-recognition 
procedure used to connect the terminal to the system (refer to the login/logout procedures 
in Volume 1, Introduction to Interactive Usage). 

This command only applies to asynchronous terminals and is not valid for X.25 PSN 
terminals. X.25 PSN terminals use the ASCII code and character set. 


60459680 D 


J-5 



(BF) - BLOCKING FACTOR 


The BF cotnmand sets the size of intermediate data blocks that will be delivered to the 
application. 

Format: 

ct BF=bf 

Parameter Description 


ct Represents the network control character for your terminal as defined 

by the CT terminal definition command. 

W Specifies the blocking factor. You can specify the following values 

for bf: 

Description 

0 Selects a line feed character and a character count of 100 

as data-forwarding signals. 

1 Selects a character count of 100 as a data-forwarding 
signal. 

2 Selects a character count of 200 as a data-forwarding 
signal. 

Regardless of the blocking factor, an end-of—line character (usually a carriage return) 
forwards data to the application. 


(BR) - BREAK KEY AS USER BREAK 1 


The BR command determines if the BREAK key (interruption key for interactive output) also 
functions as the interruption sequence (user break 1 sequence) when entered during output 
and as the cancel character when entered during input. 

Format; 

ct BR»=option 

Parameter Description 


ct Represents the network control character for your terminal as defined 

by the CT terminal definition command. 

option Determines if this feature is enabled or disabled. A value of Y 

enables and a value of N disables this feature. 

This command only applies to asynchronous terminals. For X.25 PSN terminals, the BREAK key 
can only function as the interruption sequence whether entered during input or output. 


J-6 


60459680 H 




(BS) - BACKSPACE CHARACTER 

The BS command specifies the character used to delete the previous input character. 

Format: 

ct BS=bs 

Parameter Description 

ct Represents the network control character for your terminal as defined 

by the CT terminal definition command. 

ts Specifies the new backspace character. This character must differ rom 

the characters currently defined for AB, Bl, B2, CN, CT, EB, and EL. 

It is possible to backspace only to the beginning of the current physical line; additional 
backspaces are disregarded. When a page width of 0 is selected, the network assumes a page 
width of 100 characters for backspacing. If the page width is in the range 20 through 56, 
backspacing into previous physical lines is sometimes permitted. 

This command only applies to asynchronous terminals only. 


(Bl) - INTERRUPTION OR USER BREAK 1 CHARACTER 


The Bl command specifies the character that, when entered as the only character in a logical 
line (interruption character followed by the message transmission key), causes program 
interruption. 

Format: 


ct Bl=ubl 

Parameter 

ct 

ubl 


Description 

Represents the network control character for your terminal as defined 
by the CT terminal definition command. 

Specifies the new user break 1 character. This character must differ 
from the characters currently defined for AB, BS, B2, CN, CT, EB, and 
EL. 


The interruption sequence is discussed in section 
BREAK key can also function as the Bl character. 

This command does not apply to bisynchronous 2780 


16. The BR command determines whether the 
and 3780 terminals. 
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(B2) - TERMINATION OR USER BREAK 2 CHARACTER 


The B2 command specifies the character that, when entered as the only character in a logical 
line (termination character followed by the message transmission key), causes program 
termination. 

Format: 


ct B2=ub2 

Parameter Description 

ct Represents the network control character for your terminal as defined 

by the CT terminal definition command. 

ub2 Specifies the new user break 2 character. This character must differ 

from the characters currently defined for AB, BS, Bl, CN, CT, EB, and 
KL« 

The termination sequence is discussed in section 16. 

This command does not apply to bisynchronous 2780 and 3780 terminals. 


(CH) - DISPLAY TERMINAL CHARACTERISTICS 

The CH command displays some of the terminal's current characteristics. 

Format: 
ct CH 

Parameter Description 

ct Represents the network control character for your terminal as defined 

by the CT terminal definition command. 

The CH command produces a display in the following format: 

TC=tc ,BS=bs,CN=cn,AB=ab,Bl=ubl,B2=ub2,EL=el,EB=eb 


where the variable portions appear as ASCII characters if printable, mnemonics (for example, 
STX) if nonprintable, or N/A if the attribute is not applicable. 
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(Cl) - CARRIAGE RETURN IDLE COUNT 


The Cl command specifies the number of idle characters to be inserted into the output stream 
after a carriage return. 

Format: 

ct GI=ci 

Parameter Description 

ct Represents the network control character for your terminal as defined 

by the CT terminal definition command. 

ci Specifies the new carriage return idle count. This value can be from 

0 to 127 or the string CA. A value of CA restores the carriage return 
idle count to the default value. 

When the network produces a carriage return, the network outputs the specified number of 
idle characters before outputting the next line. This allows time for the carriage return 
function and ensures that characters are not lost because of printing attempts during the 
carriage return operation. 

This command only applies to asynchronous terminals. 


(CN) ■ CANCEL CHARAaER 

The CN command specifies the character used to cancel the logical line currently being input. 
Format; 

ct CN=cn 

Parameter Description 

ct Represents the network control character for your terminal as defined 

by the CT terminal definition command. 

cn Specifies the new cancel character. This character must differ from 

the characters currently defined for BS, Bl, B2, CT, EB, and EL. 

When you enter the cancel character as the last character in a line, the entire logical line 
in progress is cancelled. The system responds to a cancel line character by printing *DEL* 
on the next line and positioning the carriage to the beginning of a new line. The BR 
command determines whether the BREAK key can also function as the CN character. 

This command does not apply to bisynchronous 2780 and 3780 terminals. 
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(CP) - CURSOR POSITIONING AFTER INPUT 


The CP command determines whether or not the system sends the terminal a response to the 
line feed key, the EL character, and the EB character. 

Format: 

ct CP=option 

Parameter Description 

ct Represents the network control character for your terminal as defined 

by the CT terminal definition command. 

option Indicates whether to send a response to the terminal or not. A value 

of Y indicates yes and N indicates no. 

This command applies only to asynchronous terminals (except 2741s). If CP=Y and IN=KB are 
selected, the system responds to the line feed key by sending a carriage return and responds 
to an EL or EB character by sending the cursor positioning response specified by the EL or 
EB command. If Il^BK is selected or you are at an X.25 PAD terminal, the system responds 
only to the EB character by sending the cursor positioning response selected by the EB 
command. 


(CT) - NETWORK CONTROL CHARACTER 

The CT command specifies a network control character for the terminal. When you enter this 
character as the first character of a logical line, it signals that what follows is a 
terminal definition command or a special command that the network forwards to your 
application with a preemptive status (refer to the interactive status commands in section 8). 

Format: 

ct CT=char 

Parameter Description 

ct Represents the current network control character for your terminal. 

char Specifies the new network control character. This character must 

differ from the characters currently defined for AB, BS, Bl, B2, CN, 

EB, and EL. 

If you enter the CT command in a line with multiple terminal definitions, the new value char 
does not take effect until the complete line is processed. 
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(DL) - DELIMITERS FOR SINGLE-MESSAGE TRANSPARENT INPUT MODE 


The DL command specifies the delimiters that terminate single~niessage transparent input 
mode. When you initiate transparent input mode (IN=X, IN=XK, or IN=XP), the network reads 
your input and sends it to the system without translation until it encounters a delimiter. 
If your terminal's parity is set to even, odd, or zero (PA=E, 0, or Z), the parity bit is 
stripped (set to zero) before the characters are sent to the host, although no translation 
occurs. If your terminal's parity is set to-none or ignore (PA=N or I), the parity bit is 
not stripped. See the NAM/CCP Terminal Interfaces Reference Manual for more information on 
transparent input and parity. The first delimiter encountered terminates transparent input 
mode. 

Format: 

ct DL=Xxx,Ccount,TO 

Parameter Description 


ct Represents the network control character for your terminal as defined 

by the CT terminal definition command. 

Xxx Specifies the 2—digit hexadecimal code (xx) of the character you want 

as a delimiter. The network does not send the character as part of 
the input data. When you specify a hexadecimal code above 7F, you 
must have previously set your terminal's parity to none (PA=N) or 
Ignore (PA=I); otherwise the network cannot detect the code when it 
occurs in a transparent mode message. If the terminal's parity is set 
to none, the 8-bit hexadecimal code input from the terminal is matched 
against the 8-bit hexadecimal code specified as the delimiter (xx). 

If the terminal's parity is set to ignore, the bottom 7 bits of the 
terminal input are matched against the bottom 7 bits of the specified 
delimiter (xx). 

Ccount Specifies a decimal value (count) from 1 to 4095 that functions as a 

character count delimiter. These values are valid within the 
network. However, unless changed during installation, the maximum 
logical input line length in lAF (2500 characters) limits you. 

TO Specifies that a timeout of between 200 and 400 milliseconds will be a 

transparent mode delimiter. 


You can select any of the three types of delimiters: character delimiter (specify Xxx), 
character count delimiter (specify Ccount), and timeout delimiter (specify TO). 

The parameter values for DL are order-independent and optional. However, you must specify 
at least one of the parameter values. You can omit trailing commas if you do not specify 
all three types of delimiters. 

Entering this command with any number of new delimiters cancels all transparent mode input 
delimiters already in effect. Including those specified with the XL command. 

The DL command applies only to asynchronous and mode 4 terminals. Terminal class 4 is 
configured with the RETURN key as the only transparent mode terminator and mode 4 terminals 
are configured with the SEND or ETX key as their only transparent mode terminator. For X.25 
devices, the PAD forwarding signal always acts as a transparent mode terminator in addition 
to any other options selected. 
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(EB) - END-OF-BLOCK CHARACTER 


The EB command defines the end—of—block character and defines the cursor—positioning 
response to that character. The EB character acts as the message transmission key for 
terminals operating in block mode (refer to the IN command). 

Format: 


ct EB=eb,cpr 


Parameter 


Description 

Ct 

Represents 
by the CT 

the network control character for your terminal as defined 
terminal definition command. 

eb 

Specifies 

following 

the new end—of—block character. You can specify the 
values for eb: 


eb 

Description 


Xxx 

Specifies the 2-digit hexadecimal code xx of the character 
you want as the end-of-block delimiter. This character 
must differ from the characters currently defined for AB, 
BS, Bl, B2, CN, and CT. 


EB 

Selects the default end-of-block character or character 
sequence. 


EL 

Selects the current logical end-of-line character. 

cpr 

Specifies the cursor-positioning response to the EB character. You 
can specify the following values for cpr: 


cpr 

Description 


CR 

Send a carriage return to the terminal. 


LF 

Send a line feed to the terminal. 


CL 

Send a carriage return and a line feed to the terminal. 


NO 

Send no response. 

The two EB parameters 

(EB=eb and 

cpr) are optional and order-independent. If you omit one. 


the system retains its previous value. 

This command is valid only for asynchronous terminals and mode 4 terminals, except for paper 
tape devices and 2741 terminals. The end-of-block character for mode 4 terminals is ETX and 
is not changeable. If you specify the char form of the eb parameter, it is only effective 
if it occurs as the last character in a line. 

The CP command enables or disables the cursor-positioning response specified by the cpr 
parameter. 
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(EL) - END-OF-LINE CHARACTER 


The EL coimnand defines the logical end-of-line character (carriage return) and defines the 
cursor—positioning response to that character* It also defines the message transmission key 
for asynchronous terminals not operating in block mode (refer to the IN command). 

Format: 


ct EL=el, cpr 
Parameter 
ct 


Description 

Represents the network control character for your terminal as defined 
by the CT terminal definition command. 


si Specifies the new logical end—of—line character. You can specify the 

following values for el: 

el Description 

5Cxx Specifies the 2—digit hexadecimal code xx of the character 
you want as the end-of-line delimiter. This character 
must differ from the characters currently defined for AB, 
BS, Bl, B2, CN, and CT. 

EB Selects the current end-of-block character or character 

sequence. 

EL Selects the default logical end-of-line character. 

cpr Specifies the cursor-positioning response to the EL character. You 

can specify the following values for cpr: 


cpr Description 

CR Send a carriage return to the terminal. 

LF Send a line feed to the terminal. 

CL Send a carriage return and a line feed to the terminal. 

NO Send no response. 

The two EL parameters (el and cpr) are optional and order-independent. If you omit one, the 
system retains its previous value. 


This command does not apply to 2741, HASP, 3270, and bisynchronous 2780 and 3780 terminals; 
the cpr parameter does not apply to mode 4 or X.25 PSN terminals; and the char specification 
does not apply to mode 4 terminals. 

The CP command enables or disables the cursor-positioning response specified by the cpr 
parameter. 
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(EP) - ECHOPLEX MODE 

The EP comnand enables or disables the echoing of input characters back to the terminal. 
Format: 

ct EP=option 

Parameter Description 


Represents the network control character for your terminal as defined 
by the CT terminal definition command. 

option Specifies whether to enable (Y) or disable (N) input echoing. 

Some terminals can perform their own character echoing, such as terminals with a HALF/FULL 
duplex switch. If the switch is in the HALF position, set the EP value to N, and the 
terminal echoes the input. If the switch is in the FULL position, set the EP value to Y and 
the network echoes the input. 

You can use the EP command and full-duplex mode as a security measure. If you are in 
full-duplex mode and EP is Y during login, the system echoes all of your input except your 
password. This is not true, however, if you enter your user name and password on the same 
line. 

This command only applies to asynchronous terminals (except 2741s). 


(FA) - FULL ASCII INPUT MODE 

The FA command enables or disables the full-ASCII input mode. 

Format: 

ct FA=option 

Parameter Description 

Represents the network control character for your terminal as defined 
by the CT terminal definition command. 

option Specifies whether to enable (Y) or disable (N) the full-ASCII input 

mode. 

In full-ASCII input, all 128 ASCII characters, including NUL, DEL, STX, LF, and all BLK and 
message-forwarding signals (which are normally discarded), are sent to the host. Exceptions 
to this are the following characters: 

• NULs, DELS and LFs when encountered as the first character of an input line or as 
the character following a message-forwarding signal 

• CRs that follow LFs when inputting from paper tape 

• DC3s that follow the EL character when inputting from paper tape 

• DCls and DC3s when output control (OC=Y) is selected 
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In full-ASCII mode, the network does not recognize the terminal functions associated with 
the mnenomics B1, B2, CN, AB, and BS. The network does recognize terminal definition 
commands and other commands beginning with the CT character. 

If SE is in effect when you select FA or if FA is in effect when you select SE, FA takes 
precedence and SE will not be effective until FA is turned off. If full-ASCII mode is 
enabled when you select transparent input mode, the network suspends the full-ASCII mode 
until the transparent input mode terminates. 

This command only applies to asynchronous and mode 4 terminals. 


(HC) - HOST CONNECTION 

The HC command disconnects you from your current host and establishes a new host 
connection. The new host connection can be selected by an HN command or by the HC command 
(HC=hostname). The HC command is equivalent to HS or HN followed by TM. 

Format: 

ct HC=hostname 

Parameter Description 


ct Represents the network control character for your terminal as defined 

by the CT terminal definition command. 

hostname Specifies the name of the host to which you want your terminal 

connected. 

The host selected is used until you change it or until your terminal is disconnected from 
the host. 


(HD) - DISPUY OF HOST NODES 

The HD command causes the host availability display (HAD) to be displayed at your terminal. 
The HAD lists all paths you can select to connect your terminal to a host. 

Format: 

ct HD 

Parameter Description 

ct Represents the network control character for your terminal as defined 

by the CT terminal definition command. 
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The HAD has the following format: 


message CONTROL CHARACTER=ct 

NPU NODE=npu TERMINAL NAME=terminal 


HOST 

NODE 

SELECTED/ 

CONNECTED 

STATUS 

host]^ 

node 2 ^ 

condition 2 

status2 

host2 

node 2 

condition 2 

status 2 

hostjj 

nodCjj 

• 

conditioojj 

• 

• 

statuSjj 


prompt response 


The variable items in the display have the following descriptions. 

Item Description 

message A message describing the status of your current host connection. 

ct Network control character currently defined for your terminal. 

npu The node number of the Network Processing Unit (NPU) your terminal 

is connected to. 

The name of your terminal. 

Represents the 1- to 7-character name of a host. The field may be 
blank. 

nodej^ Represents a node number (1-31). 

conditionj^ Indicates that you have selected node^ (S), that you are connected 

to the host using node^^ (C), or that node^^ has been automatically 
selected and the connection to the host is in progress (SA). 

statusj Represents AVAILABLE or NOT AVAILABLE. 

prompt Action to take in response to a host status message, 

message 


terminal 

host^ 
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(HN) - HOST NODE SELECTION 


The HN coimand sets or changes the host or the path (node) to a host through which your 
terminal is connected. This command does not disconnect you from your current host 
connection. You must log out or disconnect with the Secure Login command or TM terminal 
definition command before you can connect to the new selection. 

Format: 

ct HN=node 

Parameter Description 

ct Represents the network control character for your terminal as defined 

by the CT terminal definition command. 

node Specifies a node number. The default is the node the network 

processing unit is presently using to access its supervisor (CS). 

The host availability display (HAD) lists all nodes your terminal can use. Refer to the HD 
command for a description of the HAD. 


(HS) - HOST SELECTION 

The HS command selects a host which is connected to your terminal. The host availability 
display (HAD) shows the available hosts (refer to the HD command). 

Format: 

ct HS=hostname 

Parameter Description 

ct Represents the network control character for your terminal as defined 

by the CT terminal definition command. 

hostname Specifies the name of the host to which you want your terminal 

connected. The valid entries appear in the HAD. 

Your terminal uses the path to host with the least traffic. The path selected is used until 
either you change it or until your terminal is disconnected from the host. 
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(1C) - FLOW CONTROL FOR INPUT DEVICES 

The IC command specifies whether the terminal recognizes DC3s as a stop signal and DCIs as a 
resume signal for terminal input. 

Format: 

ct IC=option 

Parameter Description 

ct Represents the network control character for your terminal as defined 

by the CT terminal definition command. 

option Specifies whether to enable (Y) or disable (N) input control. 

Input control applies to asynchronous terminals, including paper tape devices (except 2741s). 

(IN) • INPUT DEVICE AND TRANSMISSION MODE 

The IN command identifies the input device and the transmission mode of the device. As the 
input device, you can specify one of the following: 

• A keyboard. 

• A paper tape reader. 

As the input transmission mode, you can specify either: 

• Normalized line mode (one message or logical line per terminal transmission block). 

• Normalized block mode (one or more logical lines or messages collected into a block 
before it is transmitted). 

• Transparent mode (input is not edited or translated by the network). 
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Format: 


ct IN=in 

Parameter 


Description 


Represents the network_ control character for your terminal as defined 
by the CT terminal definition command. 

Specifies the input device and transmission mode. You can specify the 
following values for in: 

in Description 

BK Selects block mode as from a form terminal and normalized 

input mode. 

KB Selects a keyboard in character or line mode and 

normalized input mode. 

PT Selects paper tape and normalized input mode. 

X Selects the current input device and transparent input 

mode. 

XK Selects the keyboard and transparent input mode. 

XP Selects paper tape and transparent input mode. 

When the IN value is XK, XP, or X, terminal input is sent to the host in transparent mode 

blocks. Transparent mode continues until the system encounters a previously defined 

transparent mode terminator. 

When the IN value is XK and transparent mode terminates, the IN value automatically reverts 
to KB. When the IN value is XP and transparent mode terminates, the IN value automatically 
reverts to PT. When the IN value is X and transparent mode terminates, the IN value 
automatically reverts to the value that was previously in effect. 

When the IN value is PT or XP, the network sends the X-ON code to start the paper tape 

reader automatically after the end of a message is output to the terminal and the message 

empties the terminal's output queue. 

The IN command is not applicable to HASP, 3270, or bisynchronous 2780 and 3780 terminals. 
2741 terminals can only select IN=KB, IN=X, and IN=XK. Mode 4 terminals, which are always 
in block mode, and X.25 PSN terminals cannot select PT or XP mode. 
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(LI) - UNE FEED IDLE COUNT 


The LI command specifies the number of idle characters to be inserted into the output stream 
following a line feed. 

Format: 

ct LI=value 

Parameter Description 


ct Represents the network control character for your terminal as defined by 

the CT terminal definition command. 

value Specifies the new line feed idle count. This value can be from 0 to 127 

or the string CA. A value of CA restores the line feed idle count to 
the default value. 

The line feed idle count is similar to the carriage return idle count (Cl), except that the 
idle characters are output after a line feed instead of after the carriage return. 

This command only applies to asynchronous terminals. 


(LK) - LOCKOUT OF UNSOLICITED MESSAGES 

The LK command determines whether unsolicited messages from the network operator appear at 
your terminal. 

Format; 

ct LK=option 

Parameter Description 

ct Represents the network control character for your terminal as defined by 

the CT terminal definition command. 

option Specifies whether to lock out unsolicited messages. A value of Y locks 
out the messages and a value of N allows the messages to appear. 
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(MS) - MESSAGE TO NETWORK OPERATOR 

The MS command sends a message to the network operator. 

Format: 

ct MS=message 

Parameter Description 

ct Represents the network control character for your terminal as defined 

by the CT terminal definition command. 

message Specifies your message to the operator. You can use any string of 50 

characters or less. 

If you are having problems with the network (such as difficulty connecting to lAF), you can 
communicate these problems to the network operator using the MS command. 


(OC) - FLOW CONTROL FOR OUTPUT DEVICES 

The OC command specifies whether the terminal generates DC3s as a stop signal to the network 
and DCls as a resume signal for terminal output. 

Format: 

ct 0C=option 

Parameter Description 

ct Represents the network control character for your terminal as defined 

by the CT terainal definition command. 

option Specifies whether to enable (Y) or disable (N) output control. 

If the network receives a DC3 while output control is enabled, it suspends output until it 
receives a DCl. 

Output control applies to asynchronous terminals, including paper tape devices (except 
2741s). 

(OP) - OUTPUT DEVICE SELECTION 

The OP command specifies the type of output device. 

Format: 

ct 0P=op 

Parameter Description 

ct Represents the network control character for your terminal as defined 

by the CT terminal definition command. 


60459680 H 


J-21 




Parameter 


Description 


op Specifies the output device. You can specify the following values for 

op: 

op Description 

D1 Specifies a display device. 

PR Specifies a printer. 

PT Specifies a paper tape punch. 

You can punch a tape in any mode, but the network does not provide the proper X-OFF 
characters unless OP has a value of PT. 


If you select OP=PR, the network does line folding and page bounding for asynchronous and 
X.25 PSN terminals. If OP=DI, the network assumes the terminal performs these functions 
itself. 


This command only applies to asynchronous terminals (except 2741s). OP=PT does not apply to 
X.25 PSN terminals. 


(PA) - PARITY PROCESSING 

The PA command specifies the parity processing to be performed by the network. 
Format; 

ct PA*pa 

Parameter Description 


ct Represents the network control character for your terminal as defined 

by the CT terminal definition command. 

pa Specifies the type of parity processing. You can specify the 

following values for pa: 

pa Description 

E Set parity bit for even parity during output, and check 

for even parity (except for X.25 PSN terminals) and set 
parity bit to zero on input. 

N In transparent mode, do not set or check the parity bit 

because it is part of the input or output data. In 
normalized mode, set the parity bit to zero on input and 
output. 

0 Set parity bit for odd parity during output, and check for 

odd parity (except for X.25 PSN terminals) and set parity 
bit to zero on input. 
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Parameter 


Description 


pa Description 

Z Set parity bit to zero on output and check parity bit 

against zero on input. 

I In transparent mode, do not set or check the parity bit 

because it is part of the input or output data. Ignore 
the parity bit when checking for transparent input mode 
delimiters. In normalized mode, set the parity bit to 
zero on input and output. 

This command only applies to asynchronous terminals (except 2741s). For X.25 PSN terminals, 
the parity bit is set to 0 and not checked for input. 


(PG) - PAGE WAITING 

The PG command enables or disables page waiting at the terminal during output. If you 
enable page waiting, the terminal stops at the end of each output page for your 
acknowledgement (a null input line) before output continues. (In order for the PG command 
to be effective, page length (PL) must be non-zero.) 

Format: 

ct PG=option 

Parameter Description 

ct Represents the network control character for your terminal as defined 

by the CT terminal definition command. 

option Specifies whether to enable (Y) or disable (N) page waiting. 

When you enter a null input line to get the next page of output, the null input line has no 
other meaning. 

Page waiting does not apply to bisynchronous 2780 or 3780 terminals or to HASP terminals. 


(PL) - PAGE LENGTH 

The PL command establishes the maximum number of physical lines that can be printed as one 
page. If the output device type is PR, the network automatically positions the carriage to 
the top of the form after PL lines have been output. 

Format: 

ct PL=pl 

Parameter Description 

ct Represents the network control character for your terminal as defined 

by the CT terminal definition command. 

pi Specifies the page length. You can specify 0 or any value from 8 to 

255. PL=0 selects an infinitely long page. 

The PL value must be nonzero if you want to enable page waiting, since page waiting only 
occurs after the number of lines defined by pl-1 are output. 
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(PW) - PAGE WtDTH 


The PW command establishes the maximum number of characters that the terminal prints on one 
output line. If the output device type is PR, the system automatically starts a new line 
after pw characters have been output. 

Format; 

ct PW=pw 

Parameter Description 

ct Represents the network control character for your terminal as defined 

by the CT terminal definition command. 

pw Specifies the page width. You can specify a value of 0 or any value 

from 20 to 255. PW=0 selects an infinitely long line. 


(RC) - RESET TERMINAL CHARACTERISTICS 

The RC command resets your terminal to the NDL-specified default values. Normally you would 
use this command after disconnecting from a host connection for which you had altered one or 
more terminal characteristics. 

Format: 

ct RC 

Note that a terminal can also be automatically reconfigured each time the terminal is 
disconnected from a host if the terminal is on a line for which automatic reconfiguration 
has been specified by the network administrator. 


(SE) - SPECIAL EDITING MODE 

The SE command enables or disables the special editing variant of normalized input mode. 
Format; 

ct SE=option 

Parameter Description 

ct Represents the network control character for your terminal as defined 

by the CT terminal definition command. 

option Enables (Y) or disables (N) special editing operations. 

When special editing is in effect, any backspace character entered is stored for transmission 
to the host. Similarly, a line feed entry produces a normal line feed operation at the 
terminal and the network stores the line feed character code for transmission to the host. 

A backspace followed by a line feed causes the system to output a bell. 

This command is valid only for asynchronous terminals. 
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(TC) - TERMINAL CLASS COMMAND 


The TC command specifies a terminal class for your terminal. The terminal class associates 
your terminal with a predefined set of terminal characteristics. To effectively use a 
terminal class, choose a terminal class whose default terminal definition corresponds to the 
characteristics of your terminal. 

Format: 


Description 


Represents the network control character for your terminal as defined 
by the CT terminal definition command. 

Specifies the terminal class. The value tc can be from 1 to 18. 

The following list associates terminal class values with terminal types: 


tc 

Terminal Type 

tc 

Terminal Type 

1 

M33, M35, M37, M38 teletypes 

10 

200 User Terminal 

2 

CDC 713-10, 722, 751-1, 752, 756 

11 

CDC 714-30 

3 

CDC 721, 722-30 

12 

CDC 711-10 

4 

IBM 2741 

13 

CDC 714-10/20 

5 

M40 teletypes 

14 

HASP protocol, preprint format 
control 

6 

Hazeltlne 2000 

15 

CDC 734, 731-12 

7 

Terminals conforming to the 

ANSI X3.64 standard (DEC VTIOO, 
TeleVideo 924, 950, 955) 

16 

IBM 2780 

8 

Tektronix 4010, 4014 

17 

IBM 3780 

9 

HASP protocol, postprint 
format control 

18 

IBM 3270 


A terminal that is not shown as belonging to a terminal class may still be operational. The 
terminal can be assigned to a terminal class having similar characteristics and the 
terminal s definition can be modified as necessary to correctly define the operational 
characteristics of the terminal. 

If your terminal is on an auto-recognition line and its terminal class is other than 4, 10, 
13, or 18, you can use the TC command to change its terminal class to ensure proper 
operation. 

If you include a TC command in a sequence of terminal definition commands, enter the TC 
co mma nd first as it resets all other terminal characteristics. 


ct TC=tc 

Parameter 

ct 

tc 
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(TM) - TERMINATING A TERMINAL-HOST CONNECTION 

The TM conmand terminates the connection between your terminal and a host. 

Format: 
ct TM 

Parameter Description 

ct Represents the network control character for your terminal as defined by 

the CT command. 

You can use the TM command if your application does not respond to your input. The system 
responds to the TM command in the following manner: 

HOST DISCONNECTED CONTROL CHARACTER=ct 
ENTER INPUT TO CONNECT TO HOST 
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(XL) - MULTIMESSAGE TRANSPARENT MODE 


The network provides a transparent mode that allows you to remain in transparent input mode 
even after message blocks have been forwarded to the application. The XL command specifies 
the multimessage-forwarding signal and the terminator for transparent input mode. If your 
terminal's parity is set to even, odd, or zero (PA=E, 0 or Z), the parity bit is stripped 
(set to zero) before the characters are sent, to the host, although no translation occurs. 

If your terminal's parity is set to none or ignore (PA=N or I), the parity bit is not 

See the NAM/CCP Terminal Interfaces Reference manual for more Information on 
transparent input and parity. 

Format: 


ct XL=Xxx,Ccount,TO,Yyy 
Parameter 


Description 


ct 


Xxx 


Ccount 


TO 


Yyy 


Represents the network control character for your terminal as defined by 
the CT terminal definition command. 

Selects the character with the two-digit hexadecimal representation xx 
as the message-forwarding signal. If you do not specify a value yy, the 
occurrence of two successive characters defined by xx acts as a 
terminator for transparent input mode. When you specify a hexadecimal 
code above 7F, you must have previously set your terminal's parity to 
none (PA=N) or ignore (PA=I); otherwise the network cannot detect the 
code when it occurs in a transparent mode message. 

Selects a decimal value from 1 to A095 as a character count that 
functions as a message-forwarding signal. These values (1 to 4095) are 
valid with the network. However, unless changed during installation, 
the maximum logical input line length in lAF (2500 characters) limits 
you. 

Selects timeout as a transparent input mode terminator. 

Selects the character with the two-digit hexadecimal representation yy 
as a terminator for transparent input mode when it follows xx. When you 
specify a hexadecimal code above 7F, you must have previously set your 
terminal s parity to none (PA=N) or ignore (PA=I); otherwise the network 
cannot detect the code when it occurs in a transparent mode message. 

Yyy, if specified, must follow the Xxx parameter; otherwise, it is ignored. The parameters 
are otherwise order-independent. You must specify at least one of Xxx or TO to select a 
transparent mode terminator. When it immediately follows the character defined by Xxx on 
input, the character defined by yy terminates transparent input mode. The characters 
defined by Xxx and Yyy can be identical or you can omit Yyy. In either case, two successive 
input characters defined by Xxx are required to terminate transparent mode. 

The message-forwarding signals and mode terminators are not sent to the host. 

The XL command applies only to asynchronous and mode 4 terminals. Terminal class 4 is 
configured with the RETURN key as the only transparent mode delimiter and terminator, and 
mode 4 terminals are configured with the SEND or ETX key as their only transparent mode 
delimiter and terminator. For devices connected through X.25, the PAD forwarding signal 
always acts as a transparent mode delimiter in addition to any other options selected. 

This command does not apply to HASP and bisynchronous terminals. 
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Table J-1. Default Terminal Definitions 


Mne¬ 

monic 


Description 


Terminal T/pes 


CDC 

713-10, 

722,751-1 

752,756 


CDC 

721, 

722-301 


IBM 

2741 


m 

H40-2 


HAZ 

2000 ! 


X3.64 

DEC 

VTIOO 


Tek 

40001 


X.2S 

any 


HASP 

POST, 


CDC 

714-30 


CDC 

711-10 


CDC 

714-10 

714-20 


HASP 

PRE 


IBM 

2780 


IBM 

3780 


TC 

AB 

BF 

BS 

B1 

B2 

BR 


Terminal class 
Abort output block 
Blocking factor 
Backspace character 
User break 1 
User break 2 


Break as user break 1 
(and cancel character) 


Carriage return idles 
Cancel character 
Cursor positioning 


Network control 
character 


Single-message trans¬ 
parent input mode 


Character delimiter 


Character count 
delimiter 


Timeout delimiter 
End-of-block 
Character 

Cursor positioning 
End-of-loglcal line 
Character 
Cursor positioning 
Echoplex mode 
Full ASCII input mode 


Input device flow 
control 


Input device 
Une feed idles 
Lockout NOP messages 


Output device flow 
control 


Output device 
Parity processing 
Page waiting 
Page length 
Page width 
Special editing mode 


Hultimessage 
transparent input mode 


CR 

20431 


2 

CAN 

1 

BS 

DLE 

DC4 


CR 

2043 


EOT 

Cl 


CR 

LF 


KB 

0 

N 


DI 

E 

N 

24 


3 

CAN 

I 

BS 

DLE 

DC4 

N 


0 

CAN 


CR 

2043 


EOT 

CL 


CR 

LF 

N 

N 

N 


DI 

E 

N 

30 

80 

N 


5 

CAN 

I 

none 

DLE 

DC4 


1 

CAN 

Y 

ESC 


CR 

2043 


EOT 

a 


CR 

LF 

N 


24 

80 

N 


CR 

20431 


7 

CAN 

1 


DLE 

DC4 


0 

CAN 

Y 

Z 


CR 

2043 


EOT 

CL 


CR 

2043 


( 0 ) 


( 1 ) 

CD 

(1) 

CD 

CD 


CD 

CD 


CD 


CD 


CD 

No 


BK 

CD 

CD 


(4) 


(4) 


(4) 

No 


(5) 

No 


16 

80 


(4) 


(4) 

No 


(5) 

No 


Y 

16 

80 


(4) 


(4) 

No 


C5) 

No 


16 

80 


C4> 


0 

120 


(0) Terminals belong to terminal classes 1 through 3 or 5 through 8. 

CD Same as for the terminal if it were not connected via a packec-svltching network. 

(2) End-of-packet sequence (M bit is reset to zero). 

(3) The parity bit is ignored on input and is generated for output as for the basic terminal type. 
C4) ETX (resulting from the SEND key). 

(5) ESC A (resulting from the CARRIAGE RETURN key). 

(6) Program attention key 1 is a valid user break 1. 

(7) Program attention key 2 is a valid user break 2. 
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DELIMITING AND TRANSMITTING TERMINAL INPUT 


K 


You can transmit Input to an application in normalized mode (also called character mode) or 
transparent mode (also called binary mode)* Appendix J describes how you delimit and 
transmit input in transparent mode (refer to the DL and XL commands), however the default 
input mode for all supported terminal classes is normalized mode* The remainder of this 
appendix describes how to delimit and transmit terminal input in normalized mode under the 
default conditions of the various terminal classes* (Appendix J also describes how you can 
change these defaults)* 


PHYSICAL END-OF-LINE (LINE FEED) 

In terminal classes 1 through 8, you can terminate a physical line of input (block) with a 
line feed key* The network also terminates a physical line of output whenever the page 
width of a terminal is reached and OP=PR (refer to the PW and OP command in appendix J)* 

The network may respond to the line feed key by advancing the cursor or carriage to the 
beginning of the next line (refer to the CP command in appendix J)* 


LOGICAL END-OF-LINE (CARRIAGE RETURN) 

You terminate a logical line of input with a carriage return key* A logical line can 
consist of one or more physical lines but not vice versa* The carriage return key advances 
the cursor or carriage to the beginning of the next line* 


MESSAGE TRANSMISSION 

You transmit your input to the network with the message transmission key* For terminal 
classes 1 through 8 operating in character or line mode (IN=KB), the message transmission 
key is the carriage return key. Hence, for these terminal classes, logical lines are 
transmitted separately* When the delimiter for the logical end-of—line and the transmission 
key are different (as with block mode devices. Including PSN and mode 4 terminals), the 
terminal stores logical lines until you press the transmission key* The terminal then sends 
the single transmission consisting of multiple logical lines to the network. The network in 
turn sends each logical line to the application separately. The message transmission key 
always acts as a carriage return if not immediately preceded by one. 

Table K-1 shows the keys used by the various terminal classes to perform the three functions 
just described* 
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Table K-1. Default Message Delimiters and Transmission Keys 


Function 

Terminal Class 

Physical End-of- 
llne (line feed) 

Logical End-of-line 
(carriage return) 

Message 

Transmission Keyt 

1 

LINE FEED 

1 

RETURN 

RETURN 

2 

i 

RETURN 

RETURN 

3 

i 

NEXT 

NEXT 

4 

ATTN 

RETURN 

RETURN 

5 

NEW LINE 

RETURN 

RETURN 

6 

LF 

CR 

CR 

7 

LINE FEED 

RETURN 

RETURN 

8 

LF 

RETURN 

RETURN 

9 

Variestt 

Varies+1’ 

Variestt 

10 

None 

RETURN 

SEND 

11 

None 

RETURN 

SEND 

12 

None 

NEW LINE 

ETX 

13 

None 

NEW LINE 

ETX 

14 

Variestt 

Varies+t 

Varies+t 

15 

None 

NEW LINE 

SEND 

16 

None 

EM 

EOT 

17 

None 

EM 

EOT 

18 

None 

Enter 

Enter 

tlf in block mode, refer to terminal documentation for terminal key equivalences. 

Those listed are for character and line modes. 
ttTerminals operating under HASP protocol use different keys for this purpose. 
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PASSIVE PROCEDURES 


L 


Passive procedures are procedures that do not have the parameter-prompting capability. If 
the procedure call contains errors, the job step terminates and the procedure is not 
executed. In most respects, however, the structure and behavior of passive and 
parameter-prompting procedures are highly similar. This appendix shows only the areas in 
which passive procedures differ from the parameter-prompting varieties. Section 4 describes 
parameter-prompting procedures in detail. 


.PROC DIRECTIVE 

This format of the .FROC directive does not provide for parameter prompting nor will the 
system give parameter descriptions or other help. 

Format: 

.PR0C,pname,pi,p2,...,pn. 

Parameters Description 

pname Name of the procedure. One to seven alphanumeric characters. As with 

file names, the name of a procedure should begin with a letter. 

Pi Optional formal parameters whose keywords are used in the body of the 

procedure. Depending on the parameters specified in the procedure call, 
keywords in the procedure body can be removed, left as they are, 
replaced by a value specified in the procedure call, or replaced by 
first or second default values as specified on the procedure header 
parameter (refer to keyword substitution in this section). 

The maximum number of procedure header keywords is defined by the 
installation. The default is 50. 

The following are the acceptable formats for p£. 

Format 

keyword 
keyword* 
keyword=defaultl 
keyword*defaultl/default2 
keyword“/default2 

keyword*#DATA (CDC graphics: keyword* = DATA) 
keyword-^PRIMARY (CDC graphics: keyword* =PRIMARY) 
keyword-#FILE (CDC graphics: keyword* =FILE) 

keyword A 1- to 10—character keyword. 

defaultl A 1- to 40-character first default value. If 

defaultl contains special characters, it must be 
$-delimited. This default value replaces the 
keyword in the procedure body if this parameter is 
omitted from the procedure call. This option is 
similar to *K on interactive procedures. 


Example 

FILEl 
FILEl* 
FILE1*LG0 
FILEl-LGO/OLD 
F1LE1*/0LD 
FILEl-#DATA 
FILE1-#PRIMARY 
FILE1*#FILE 
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Parameters 


Description 


de£ault2 A 1- to 40-character second default value. If 

default2 contains special characters, it must be 
$-delimited. This default value replaces the 
ke3rword if the procedure call specifies a parameter 
value identical to the keyword. This option is 
similar to *N or *D on interactive procedures. 


default 1 and default2 could be any of the following special values. 


#FILE 


#DATA 


^PRIMARY 


Special default value used for keyword if an 
overriding value is not specified on the procedure 
call. If this default value is used, keyword within 
the procedure body references the record that 
Immediately follows the procedure record on the file. 

If the procedure resides on a library and is called 
by a name call form of the BEGIN command, keyword is 
replaced by a null value. 

Special default value used for keyword if an 
overriding value is not specified on the procedure 
call. If this default value is used, keyword within 
the procedure body references a data file created 
within the procedure by the .DATA directive (refer 
to .DATA directive in section 4). 

Special default value used for keyword if an 
overriding value is not specified on the procedure 
call. If this default value is used, keyword within 
the procedure body refers to the job's primary file 
(refer to File Types in section 2). 


PROCEDURE AND PARAMETER DESCRIPTIONS 

You cannot include the .HELP or .ENDHELP directive in your procedure body. Hence, you 
cannot provide the procedure caller with a description of the procedure or any of its 
parameters unless the caller has already entered an error—free procedure call. 


PARAMETER MATCHING 

When a procedure is called, the system must match each parameter on the call command to a 
parameter on the procedure header command. The system uses two methods of parameter 
matching; order-dependent and order-independent. 


ORDER-DB>ENDENT PARAMETER MATCHING MODE 

Parameter matching always begins in order-dependent mode (refer to Order—Independent 
Parameter Matching Mode for Information on changing parameter matching modes). The system 
compares, in order, each parameter on the BEGIN command with the parameter in that position 
on the procedure header directive. The system then substitutes the selected parameters into 
the procedure body. 

All possible parameter substitutions in order—dependent mode are summarized in table L—1. 

The table shows each parameter format on the BEGIN command, each parameter format on the 
procedure header, and the substitution resulting from each combination. In the table the 
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word value Indicates that the parameter in the BEGIN command (called value) is different 
than the corresponding keyword and/or defaults on the procedure header. Keyword in the 
BEG3CN Command Parameter Format heading means the keyword in the BEGIN command Is identical 
to the keyword in the procedure header parameter. 

Assuming that all parameter matches between the BEGIN command and the procedinre header are 
valid for order-dependent mode (table L-1), the systen ccsapletes parameter matching in 
order-dependent mode. 

In order-dependent mode, the system ignores excess parameters on the BEGIN command. 

Use table L-1 with the following examples to clarify the meaning of the table entries 
(ke 3 Word, defaultl, default2, valtie, and null). 


Examples; Parameter Matching in Order-Dependent Mode. 
Procedure on File 

Named MIFILE Call and Substitution 


.PR0C,SAMPL1,L,M,N=XY. BEGIN,SAMPL1,MYFILE. 
REWIND,L,A,M,N. yields 

REWIND,L,A,H,XY. 


BEGIN, SAM PL1,«YFILE„,N. 

yields 

REWIND,L,A,M,N. 


8EGIN,SAMPL1,MYF1LE,$*$,C. 

yields 

REWIND,*,A,C,XY. 


.PR0C,SAHPL2,LFN1=,LFN2, BEGIN,SAMPL2,HYFILE. 

S8F=/SBF. yields 

C0PY_SBF,LFN1,LFN2. C0PY,,LFN2. 


Explanation 


When parameters are omitted on 
the BEGIN command, the system 
uses the defaults from the 
procedure header (L, M, and XY). 

Omitted parameters indicate use 
of the procedure header defaults 
(L and M). N overrides the pro¬ 
cedure header default (XY). 

Special characters must be 
$-delimlted. The asterisk (*) 
replaces M. The system uses the 
procedure header default (XY) 
for the omitted parameter. 

Omitted parameters indicate use 
of procedure header defaults 
(LFN2 and null substitution for 
LFNl and SBF). 


BEGIN,SAMPL2,MYFILE,,,SBF. 
yields 


COPYSBF,,LFN2. 


Omitted parameters indicate use 
of procedure header defaults 
(null and LFN2). The BEGIN 
command parameter, SBF, indi¬ 
cates use of the secoi^ default 
of the SBF procedure header 
parameter (SBF). The linking 

character (_) connects COPY 

and SBF to make COPYSBF. 


.PROC,SAMPL3,PFN, 
P1=/$M=W$. 
ATTACH,PFN/P1. 


BEGIN,SAMPL2,MYFILE,F0RMS,0UTPUT. 

yields 

COPY,FORMS,Oin-pUT. 


BEGIN,SAMPL3,MYFILE,TAXES,P1. 

yields 

ATTACH,TAXES/M=W. 


FORMS replaces LFNl and OUTPUT 
replaces LFN2. Since the third 
parameter is csaltted, the system 
uses the procedure header de¬ 
fault (null). 

TAXES replaces IFN and the char¬ 
acter string replaces PI. 
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Table L-1. Parameter Substitution In Order-Dependent Mode 




BEGIN Command Parameter Format 



omitted 

keyword 

value 

$value$ 

Procedure 

Header 

keyword 

.keyword 

keyword 

value 

value 

Parameter 

Format 

keyword= 

null 

ke3Word 

value 

value 


keyword=defaultl 

default1 

keyword 

value 

value 


keyword=defaultl/default2t' 

defaultl 

default2 

error 

error 


^ Switches ke 3 ^ord substitution to order—independent mode for all subsequent parameters* 


Example 1: 


The following procedure is on file PROCFIL. It prepares a file for processing. If the file 
is local, it is rewound. If it is not local, the system searches for the file in your 
permanent file catalog. If the file is not found, the procedure reverts and aborts. 

.PROC,PREPARE,FNAME=,M=R. 

IF,FILE(FNAHE,AS),PREP1. 

REWIND^FNAME. 

REVERT. FNAME PREPARED. 

EN DIF, PREP 1. 

ATTACH,FNAHE/#M=M,NA. 

IF,FILE(FNAHE,.N0T.AS),PREP2. 

GET,FNAME/NA. 

IF, FILE ( FNAH E, . NOT . AS ) , PRE P3. 

REVERT,«ORT. FNAME NOT FOUND. 

ENDIF,PREP3. 

ENDIF,PREP2. 

REVERT. FNAME PREPARED. 

EXIT. 

REVERT,ABORT. PREPARE ERRORS. 


Prepare file TEST with the following command. 
BEG1N,PREPARE,,TEST. 
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Since PROCFIL is the default file, it does not have to be specified and is noted by 
successive commas. 

The following is a segment of the dayfile that results when the BEGIN command is processed. 

08.26,45. ffiEGIN,PREPARE„TEST. 

08.26.46.IF,FILE aEST,AS),PREPl. 

08.26.46.ENDIF,PREP1. 

08.26.46.ATTACH,TEST/M=R,NA. 

08.26.46. TEST IS INDIRECT ACCESS, AT 000121. 

08.26.46.IF,FILE(TEST,.NOT.AS),PREP2. 

08.26.46.GET,TEST/NA. 

08.26.47.IF,FILEaEST,.N0T.AS),PREP3. 

08.26.47.ENDIF,PREP3. 

08.26.47.ENDIF,PREP2. 

08.26.47.REVERT. TEST PREPARED. 


Example 2: Parameter Matching in Nested Procedures (Order-Dependent Parameter Matching Mode) 


The substitutions made in a procedure that calls a second procedure are shown in figure 
L-1. The restiltant dayfile is shown on the right side of the figure. 


GET,PR0GRAM1. 

BEGIN, EXEC WE,PFILE1,PR0GRAM1, PRINT. 


PFILE1 

.PR0C,EXECUTE,NAME,0UT. 

FTN5,I=NAME,L=0UT. 

LGO. 

IF,EF*0,DR0P. 

8E6IN,LISTING,PFILE2,0UT. 

ENDIF,DR0P. 


PFILE2 

. PROC, LIST ING, OW FILE =0UT. 
REWIND,OUTFILE. 

C OPY SB F, OUT FILE , OUT PUT. 


RESULTANT DAYFILE 
16.01.08.GET,PR0GRM1. 

16.01.08.BEGIN,EXECUTE,PFILE1,PR0GRM1,PRINT. 

16.01.09.FTN5,I=PR0GRM1,L=PRINT. 

16.01.10. .043 CP SECONDS COMPILATION TIME 

16.01.10.LGO. 

16.01.11. STOP 

16.01.11. .038 CP SECONDS EXECWION TIME 

16.01.12.IF,EF*0,DR0P. 

16.01.12.BEGIN,LISTING,PFILE2,PRINr. 
16.01.12.REWIND,PRINT. 

16.01.13. CO PYSB F, PR INT,0 W PUT. 

16.01.13. END OF INFORMATION ENCOUNTERED. 

16.01.13.$REVERT.CCL 

16.01.13.ENDIF,DR0P. 

16.01.13.$REVERT.CCL 


Figure L-1. Keyword Substitution in Two Procedures 
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ORDER-INDB>ENDENT PARAMETER MATCHING MODE 


The system switches to order-Indpendent mode to match the remainder of the parameters If in 
cranparlson of a BEGIN coomand parameter and a procedure header parameter one of the 
following occurs. 

• A BEGIN command parameter Is In the format keyword= or keyword=valtffi. 

• A procedure header ccmimand parameter Is in the format keyword=defauit/defaiLLt2. 

For each BEGIN command parameter, matching always begins in order—dependent mode. Once in 
order-Independent mode, the system matches each keyword of the BEGIN ccmmand to the 
Identical keyword in the procedure header command, regardless of order. 

The following conmands Illustrate the parameter combinations that restilt in switching from 
order-dependent mode to order-Independent mode. 

Procedure on Default 

File PROCFIL Call and Substitution Explanation 

.PROC,SALES,TAX,TOTAL=, 

FLAG=A. 

COPYL,TAX,TOTAL,HOLD,,FUG. 

REPLACE,HOLD=TAX. 


The TAX=FED/MN procedure 
parameter switches the mode 
to order-independent mode. 
All parameters will be 
matched in order-independent 
mode. 

All possible parameter siibstltutions in order-Independent mode are summarized in table L—2. 
The table shows each parameter format on the BEGIN command, each parameter format on the 
procedure header command, and the substitution resulting frcm each combination. 

In the table the word value indicates that the parameter in the BEGIN command (called value) 
is different than the keyword and/or defaults on the procedure header ccanmand. Use table 
L—2 with the following examples to clarify the meaning of the table entries (keyword, 
defaultl, default!, value, and null). 


.PROC,TAXES,TAX=FED/MN, BEGIN,TAXES,,TAX,DEDUCT. 

DEDUCT,FLAG=A. yields 

COPYL,TAX,DEDUCT,HOLD,,FLAG. COPYL,MN,DEDUCT,HOLD,,A. 
REPLACE,HOLD=TAX. REPLACE,HOLD=MN. 


BEGIN,SALES,,TAX,TOTAL=SUM,FLAG. Parameter matching starts In 
yields order-dependent mode. The 

COPYL,TAX,SUM,HOLD„A. BEGIN parameter TOTAL=SUM 

REPLACE,H0LD=TAX. switches the mode to order- 

independent mode. FLAG is 
then matched in order- 
independent mode, which 
yields A. 
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Examples of Parameter Matching: 


Procedure on Default 

File PROCFIL 

Call and Substitution 

Explanation 

.PR0C,SAMPL1,L,M,N=XY. 

REW1ND,L,A,H,N. 

BEGIN,SAMPL1,,L=SWITCH, 
yields 

REWIND,SWITCH,A,M,XY. 

The L=SWITCH BEGIN parameter 
switches parameter matching mode 
to order-IndepeiKient mode. 



Order-Independent mode tees the 
procedure header defaults for 
omitted BEGIN parameters. Order- 
dependent and order-independent 
modes work identically for 
omitted BEGIN parameters. 


BEGIN,SAHPL1,,L=CHANG,M,N. 
or 

BEGIN,SAMPL1,,L=CHANG,N,M. 
yields 

REWINO,CHANG,A,M,XY. 

The L=CHANG parameter switches 
parameter matching to order- 
independent mode. In order- 
independent mode the order of the 
BEGIN parameters does not 
matter. M matches with M, and 
the N BEGIN keyword Indicates 
substitution of the procedure 
header default (XT). 


BEGIN,SAMPL1,,L=FLIP,M=B,N=Z. 

yields 

REWIND,FLIP,A,B,Z. 

BEGIN parameters in the form 
keyword=value always override 
procedure header parameters. 

FLIP replaces L, B replaces M, 
and Z replaces XY. 

.PR0C,TRACE,1N,0UT, 

TC=E0I,N=1. 

COPY,IN,0UT,,,TC,N. 

BEGIN,TRACE,,IN=,OUT=HOLD,N=. 

yields 

COPY,,HOLD,,,EOI,. 

The IN“ parameter switches 
parameter matching to order- 
independent mode. All BEGIN 
commands in the form keyword" 
use ntiU substitution. 

.PR0C,SA«PLA,FILE1, 

EC=B6/A6,DC=LP,REP=0. 

REWIND,FILE1. 

ROUTE,FILE1,#DC=DC, 
#EC=EC,#REP=REP. 

BEGIN,SAMPL4,,COIN. 

yields 

REWIND,COIN. 

ROUTE,C0IN,DC=LP,EC=86,REP=0. 

COIN is substituted in order- 
dependent mode. EC"B6/A6 
switches the mode to order- 
independent mode. The omitted 
parameters indicate use of the 
procedure header defaults (order- 
dependent azid order-independent 
modes work alike for omitted 

BEGIN parameters). 


BEGIN,SAMPL4,,C0IN,EC,DC,REP. 

yields 

REWIND,COIN. 

ROUTE,COIN,DC=LP,EC=A6,REP=0. 

EC"B6/A6 switches the mode to 
order-independent mode. Specify¬ 
ing the keyword on the BEGIN 
command produces the same result 
as cmilttiiig them (refer to pre¬ 
vious example) except for the 
double default procedure param¬ 
eter, EC"B6/A6. If K is 
omitted, B6 is used. If EC is 
specified, A6 is used. 
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Table L-2. Parameter Substitution In Order-Independent Mode 





BEGIN Command Parameter Format 




omitted 

keyword 

keyword= 

keyword=value 

value 

or 

$value$T' 

Procedure 

keyword 

keyword 

keyword 

null 

value 

error 

Header 







Parameter 

keyword= 

null 

null 

null 

value 

error 

Format 








keyword=def ault1 

defaultl 

defaultl 

null 

value 

error 


keyword=default1/ 
default2 

defaultl 

default2 

null 

value 

error 

t Assumes 

the parameter is entered under order-independent mode. 




Example 1: 

The following procedure is the same procedure as Example 2 in Order-Dependent Parameter 
Matching Mode. It resides on file PROCFIL. It routes a specified file (FNAME) to the 
specified equipment (default is any CDC-graphics line printer). 

.PROC,PRINTR^FNA«E,REP=0,DC=LP,EC=B6. 

REWIND^FNAME. 

ROUTE,FNAHE,#DC=DC^#REP=REP,#EC=EC. 

REVERT. FNAME ROUTED. 

EXIT. 

REVERT,ABORT. PRINTR PARAMETER ERRORS. 

The following command calls the procedure PRINTR. The system matches COLOR in 
order-dependent form. DC=SB switches the mode to order-independent mode. SB Indicates the 
file is to be punched. 

BEGIN,PRINTR,,COLOR,DC=SB,EC=SB. 

The following is a segment of the dayfile that results when the BEGIN command is processed. 

15.27.26. $BEGIN,PRINTR„C0L0R,DC=SB,EC=SB. 

15.27.27. REWIND,COLOR. 

L5.27.27.ROUTE,COLOR,DC=SB,REP=0,EC=SB. 

15.27.27. ROUTE COMPLETE. 

15.27.28. REVERT. COLOR ROUTED. 


L-8 


60459680 J 









Example 2: Parameter Matching in Nested Procedures (Order-Dependent and Order-Independent 
Parameter Matching Modes) 

As shown in figure L-2, procedures ROUT and PREPARE reside on the default file PROOFIL. A 
BEGIN command within ROUT calls PREPARE. In procedinre RODT the siibstitutlon for the FNAME 
parameter (TEST) is passed to procedure PREPARE by the BEGIN command. The resulting dayfile 
is on the right side of figure L-2. 

BEGIN,R0UT,,TEST,EC=A9,SBF. 

PROCFIL Resultant Dayfile 


.PR0C,R0UT,FNAME=L,SBF=/SBF,REP=0, 

EC=B6,DC=LP. 

BEG1N,PREPARE,,#FNAME=FNAME. 

CO PY_SB F, F N AM E, HO LD . 

REWIND,HOLD. 

IF,$EC$.EQ.$A9$,JUMP. 

FCOPY,P=HOLD,N=TEMP. 

RENAME,HOLD=TEMP. 

ENDIF,JUMP. 

REWIND,HOLD. 

ROiriE , HOLD, #D C=D C, #EC =EC , #REP=REP. 
REVERT. FNAME -> PRINTER. 

EXn. 

REVERT,ABORT. ROUT ERRORS. 

-EOR- 


-EOR- 

.PROC,PREPARE,FNAME=,M=R. 

IF,FILE(FNAME,AS),PREP1. 

REWIND,FNAME. 

REVERT. FNAME PREPARED. 

ENDIF,PREP1. 

ATTACH,FNAME/#M=M,NA. 

IF,FILE(FNAME,.NOT.AS),PREP2. 

GET,FNAME/NA. 

1F, FILE (FNAME,. NOT. AS ) ,PREP3. 

REVERT,ABORT. FNAME NOT FOUND. 

ENDIF,PREP3. 

ENDI F,PREP2. 

REVERT. FNAME PREPARED. 

EXIT. 

REVERT,ABORT. PREPARE ERRORS. 

BEGIN calls procedure RODT. The SBF=/SBF parameter switches parameter matching to 
order-indepeirfent mode. The first command of ROUT is a BEGIN command that calls pro¬ 
cedure PREPARE. The parameters are matched in order-independent mode. PREPARE readies 
a file for processing. If the file is local, it is rewound. If it is not local, the 
system searches for the file in your permanent file catalog. If the file is not found, 
the procedure revets and aborts. If the file is found, processing continues with the 
second command in procedure ROUT. The file is prepared for printing. Since the file is 
to be printed with the ASCII graphic 95-character set (EC-A9), the file must be changed 
to a 12-blt A^U code file (FCOPY). The procedure then routes the file to the printer 
and reverts to the command following the BEGIN command. 

Figure L-2. Ke}word Substitution in Nested Procedures 


15.27.50. $BEGIN,R0UT,,TEST,EC=A9,SBF. 

15.27.50. BEGIN,PREPARE,,FNAME=TEST. 
15.27.51.IF,FILE(TEST,AS),PREP1. 

15.27.51. REWIND,TEST. 

15.27.51. REVERT. TEST PREPARED. 

15.27.51. COPYSBF,TEST,HOLD. 

15.27.52. EOI ENCOUNTERED. 

15.27.52. REWIND,HOLD. 
15.27.52.IF,$A9$.EQ.$A9$,JUMP. 

15.27.52. FCOPY,P=HOLD,N=TEMP. 

15.27.52. FCOPY COMPLETE. 

15.27.52. RENAME,H0LD=TEMP. 

15.27.52. ENDIF,JUMP. 

15.27.52. REWIND,H0LD. 

15.27.52. ROUTE,H0LD,DC=LP,EC=A9,REP=0. 

15.27.53. ROUTE COMPLETE. 

15.27.53. REVERT. TEST -> PRINTER. 
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PAPER TAPE OPERATIONS 


M 


GENERAL DESCRIPTION 

Paper tape is used for preparing input off-line (when time is not charged) and entering it 
on-line (when t±ae is charged). This ensures accuracy and speed when most needed. An input 
tape can include programs, data, and commands. Accordingly, it Is possible for the entire 
terminal operation, after login, to be run fron paper tape. 

TELETYPEWRITER 

This discussion assumes a typical teletypewriter (model 33) with a paper tape punch and a 
paper tape reader. 

The paper tape punch has four buttons with the following labels and use. 

Button Description 

ON Turns the punch on. 

OFF Turns the punch off. 

REL. Releases the feedwheel so you can freely move the tape through the punch 

head. 

B.SP. Backspaces the tape one row of holes each time it is pressed. This is 

used to make corrections when preparing a tape off-line (refer to 
Corrections in this section). 

The paper tape reader has one switch with four positions. Position labels and use are as 
follows: 

Position r*E script ion 

START Starts the reader. After switch is momentarily held in this position, 

it snaps back to the ADTO position and reading continues. 

STOP Immediately stops reading. 

AUTO This position is used in conjunction with the input and processing of 

commands and data in tape mode (refer to Tape Mode in this section). It 
allows the tape reader to be turned off and on so that processing of 
each command or line of data can be completed before additional input is 
entered. 

free Releases the feedwheel so you can freely slide the tape in and out of 

the read head. 
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On teletypewriters lacking an AUTO position, 
reading must be manually restarted each time 
it has been stopped. 
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CONTROL CHARACTERS 


Each line of Input from paper tape must end with a particular sequence of control 
characters* These are pimched by functional keys on the telet3rpewrIter keyboard* The 
control characters used with paper tape are as follows: 


Character 


LF 


Cm/X-OFF 


RO(n) 


NUL 


Description 

Message terminator* This Is the RETURN key on the model 33* It 
moves the print head to the beginning of the line and informs lAF 
that this line of input is completed* 

Line feed* This is the LINE FEED key on the keyboard* It advances 
the paper roller one line* In normal mode, lAF sends a signal that 
Initiates this feed; in tape mode, this signal is not sent and is 
therefore required on tape* 

X-off* The appearance of this character on the tape during reading 
turns the tape reader off* This character Is punched by holding 
down the CTRL key and pressing the X-OFF key* 

Rubout* This is the RDB OUT key on the keyboard* It punches a full 
row of holes* This row is interpreted as nid.1 by the system, and 
hence this character is used for spacing and overpunching errors* 

The n parameter specifies the minimus number of times this character 
should be pmched in sequence* 

Null* This is the ASCII character represented by a feed hole only 
(blank tape)* It may be used as a fill character* 


INPUT LINES 

The following line formats are used to enter programs, data, and commands* The left half of 
the page shows an example of the input; the right half of the page shows the control 
characters that immediately follow the last input character* Each line is terminated with 
three rubouts to provide separation from the next line and bo allow time for the carriage to 
reti:rn to the left margin* While it is possible that adequate separation is provided with 
less than three rubouts, this is the recommended nunber* 


PROGRAM LINE 




100 PROGRAM TEST 


LF 

RO(3) 

DATA LINE 




? 12*44,18*31,29*08 

@ 

LF 

CTRL/X-OFF R0(3) 


(The ? is supplied by LAF* The remainder of the line comes from the tape* 
X-OFF turns the reader off to allow this data to be processed before the next 
line is read*) 


COMMAND LINE 

CATLIST,IO=F @ LF CTRL/X-OFF R0(3) 

(X—OFF turns the reader off to allow processing of the command to be completed 
before the next line is read*) 
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PUNCHING TAPE OFF-UNE 

The following procedure is used to punch a tape when the teletypewriter terminal is not 
logged in. 

1. Place the teletypewriter in local mode. 

2. Tam the paper tape punch on by pressing the ON button located on the punch. 

3. Prepare a tape leader of about 30 rubouts (3 inches) either by simultaneously 

pressing the RUB OUT and REPT keys or, if the terminal has the capability, by 
punching blank tape. 

4. With a pencil, trace the arrow above the punch output onto the tape. This 

identifies the start of the tape for reading. (It is possible to put the tape in 

the reader backwards.) 

5. Type in the input lines with their appropriate control characters. 

6. Add a 3—inch trailer of rubouts or blank tape and tear the tape off. 

7. Turn the teletypewriter off. 


TAPE MODE 

To read and process data and commands from tape, it is necessary that the tape reader be 
turned off, to allow time for processing, then be restarted. By entering tape mode, you 
enable LAP to synchronize tape input with its processing.t 

You enter tape mode by using the TRMDEF command (section 8) or a terminal definition command 
(appendix K) to change the input device to a paper tape reader. To do this with the TRMDEF 
command, enter: 

TRMDEF,IN=PT 

To perform the same operation with a terminal definition command, press the ESC kejrf'f 
(assuming a model 33 teletypewriter is being used) and enter 


IN=FT 


The TRMDEF command can specify the input device to be in character mode (FT or KB) only; to 
specify the input device is in transparent input mode (XP, XK, or X), a terminal definition 
command must be used. For all other paper tape operations, the TRMDEF command and terminal 
definition commands can be used Interchangeably. The remainder of this section will use the 
TRMDEF command in examples. 

The network acknowledges entry into tape mode with the response "IN ACCEPTED." If the 
reader switch is in the AUTO position,, reading begins automatically; if the reader switch is 
in the OFF position, reading does not begin until it is manually initiated by momentarily 
moving the switch to START. 


fYou cannot use paper tape mode from terminals connected to a packet switching network 
(PSN). 

ttThe ESC key is the default control character for terminal class 1. It must be pressed to 
signal the entry of a terminal definition command. Because the control character differs 
for some terminals, refer to appendix J for the default values for all terminal classes. 
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You can exit from tape mode by using the TSKDEF command or a terminal definition command to 
change the input device back to the keyboard. This can be done with TRMDEF by entering: 

TRMIEF,IN«da5 

The paper tape punch can also be defined as the output device using the TKMDEF command or a 
terminal definition ccanmand. This can be done by entering: 

1I!MIST,0P=PT 

You specify this command to enter tape mode for outputting information to paper tape. This 
mode provides the proper X-OFF characters when punching the tape. You can exits this mode 
by using the IKMDEF command or a terminal definition command to change the output device 
back to a printer. This can be done by entering: 

TRMnEF,OP=PR 


PUNCHING A TAPE ON-LINE 

To punch a tape with information already contained in a system file, the following procedure 
is used. 


1. If not logged in, log in. 

2. If not in tape mode, enter TI!MDEF,OP=PT. 

3. lype in LIST If the primary file is to be punched; type in LIST,F=lfn- if a local 
file other than the primary file is to be punched. Do not press @. 

4. Turn the punch on. 

5. Run a leader of rubouts or blank tape. 

6. Press @. The file is listed and punched simultaneously. The network adds the 
appropriate control characters at the end of each line. 

7. Run a trailer of rubouts or blank tape. 


CORRECTIONS 

When punching a tape off-line, corrections can be made by backspacing over the incorrect 
punch (use the B.SP. button on the punch) and punching a rubout over the error (use the RUB 
OUT key on the keyboard). Then punch in the correct character. 

It is also possible to make corrections by using the backspace key as in normal, on-line 
operation. However, the error and/or any overtyping appear in the printout. When line 
nunbers are being used, an erroneous line can be retyped (and repunched) with the same line 
nuaber. Although the erroneous and correct versions appear in the printout, lAF retains 
only the last occtirrence of the specific nusbered line during processing. 
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Example: 


In this example, the input tape contains only program lines. Commands and input are typed 
before and after the tape is read. 


The following is the tape as pimched. The left half of the page shows the printed copy 
produced as the tape is punched; the right half of.the page shows the control characters 
entered at the end of each line but not printed. 


100 

LET FACT0R=1 


LF 

RO(3) 

110 

INPUT N 

@ 

LF 

R0(3) 

120 

FOR 1=1 TO N 

@ 

LF 

R0(3) 

130 

LET FACT0R=FACT0R*I 

0 

LF 

R0(3) 

140 

PRINT FACTOR 

@ 

LF 

R0(3) 

150 

NEXT I 

0 

LF 

R0(3) 

160 

END' 

0 

LF 

R0(30) 


To demonstrate the use of this tape, you must be logged in under the null subsystem. You 
position the tape in the reader and set the reader switch to AUTO. The following is the 
printout that results. The right half of the page contains explanations of the action. 


basic - By typing this command, you enter 

READY. the BASIC subsystem. 


new,fact1 


You t 3 ?pe in this line to establish a 
new primary file with the name FACTl. 


trmdef,in=pt As soon as this command is typed in 

and takes effect, the tape reader 
goes on and the entire tape (seven 
lines) is read in. The 

100 LET FACT0R=1 reader runs through the trailer of 

110 INPUT N rubouts and then turns itself off. 

120 FOR 1=1 TO N 

130 LET FACT0R=FACT0R*I 

1A0 PRINT FACTOR 

150 NEXT I 

160 END 


READY. 

trmdef ,in=kb --You change the inprut device back to 

the keyboard. 

READY, 
run 


ILLEGAL STATEMENT AT 100 
ILLEGAL STATEMENT AT 130 
ILLEGAL STATEMENT AT 1A0 
BASIC COMPILATION ERRORS 

100 let f=1 -You type in the corrective coding 

130 let f=f*i shown. 

140 print f 


You type in RUN and receive the 
diagnostics 

shown. BASIC variables cannot be 
more than two characters. 
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run 


? 5 
1 
2 
6 

24 

120 

RUN COMPLETE, 
trmdef,op=pt - 


READY. 

List 


100 LET F=1 — 

110 INPUT N 
120 FOR 1=1 TO N 
130 LET F=F*I 
140 PRINT F 
150 NEXT I 
160 END 


READY. 


You initiate another run with the 
RUN command. lAF replies with ?. 
You enter a 5 and receive the 
desired printout. 


-You want to punch a new tape 
containing this corrected program. 
You select paper tape as your output 
mode. 

•You type LIST but do not press the 
@. You turn on the paper tape 
punch and run off a leader of blank 
tape. You then press the @ . This 
punches a CR on the tape and the 
network responds with LF and NUL 
punches. These three punches are 
not part of the file, and you must 
replace them with rubouts if you use 
the tape for subsequent input. 

lAF begins the listing with a 
sequence of CR, NUL(n), LF, and 
NUL(m).t BRIEF mode suppresses this 
sequence. 

lAF punches the tape as it lists the 
file. lAF terminates each line with 
CR, NUL(n), LF, NUL(m), DC3, and 
NUL(2).tt 

• lAF punches READY, after it has 
punched the contents of the file. A 
CR-NUL(n)-LF-NUL(m) punch sequence 
precedes and follows this message. 


tif you enter this tape as input, the CR and LF should be rubbed out, so that the system 
does not read them as an empty line. The system ignores all NDLs. 

to table K-1 in appendix K to find n, the carriage return idle count, and m, the 
line feed idle count, for your terminal class. 
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Example: 


In this example, the input tape contains not only a program but also the commands to 
execute, modify, list, ami save that program and the input data used by that program. 

The following is the complete tape as punched. The left half of the page gives the printed 
copy produced as the tape is punched; the right half of the page shows the control 
characters entered at the end of each line but not printed. 


FORTRAN 

R0(30) 
@ .LF 

CTRL/X-OFF 

R0(3) 

NEW,DEMO 

@LF 

CTRL/X-OFF 

R0(3) 

100 PROGRAM DEMO 

0 LF 

R0(3) 


110 DIMENSION 11(5) 

@LF 

R0(3) 


120 READ 10, (II(J),J=1,5) 

0_ LF 

R0(3) 


130 10 FORMAT (515) 

@)LF 

R0(3) 


140 PRINT 20, (II(J),J=1,5) 

LF 

R0(3) 


150 20 FORMAT(5110) 

^@LF 

R0(3) 


160 END 

@ LF 

R0(3) 


RUN 

@LF 

CTRL/X-OFF 

R0(3) 

1111122222333334444455555 

@ LF 

CTRL/X-OFF 

R0(3) 

SAVE,DEM0=TAPE1 

@LF 

CTRL/X-OFF 

R0(3) 

135 DO 1 1=1,5 

@ LF 

R0(3) 


137 II(I)=II(I)+4444 

@LF 

R0(3) 


139 1 CONTINUE 

@ LF 

R0(3) 


RESE€l,100,5 

@LF 

CTRL/X-OFF 

R0(3) 

LIST 

@ LF 

CTRL/X-OFF 

R0(3) 

RUN 

@LF 

CTRL/X-OFF 

R0(3) 

1111122222333334444455555 

@ LF 

CTRL/X-OFF 

R0(3) 

REPLACE,DEM0=TAPE1 

©LF 

CTRL/X-OFF 

R0(30) 


To execute this tape, you log in to lAF, position the tape in the reader, set the reader 
switch to AUTO, type the command TRMDEF,IN=PT and, upon pressing©., start the reading of 
the tape. You then observe the remainder of the action without iiTtervention. 
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The following is the printout of the execution of the tape. The right half of the page 
contains explanations of the action. 


FORTRAN -«i -rrTT_When this line is read, the reader 

stops. As soon as FORTRAN is 
established as the current 
subsystem, lAF turns the reader back 
on. 


NEW,DEN0~4-When this line is read, the reader 

stops. After a new primary file 
called DEMO is established, LAF 
turns the reader back on. 

The seven lines of the program are 
read without interruption. 


After the command to run the program 
is read, the reader is turned off. 

? 1111122222333334444455555 .-. Aftpr processing reaches the READ 

statement (line 120) and after lAF 
prints ?, lAF turns the reader on, 
and the line of data is read. Then 
the reader is turned off to allow 
data processing. 

Resulting printout: 


100 PROGRAM DEMO.-.- 

110 DIMENSION 11(5) 

120 READ 10, (II(J),J=1,5) 
130 10 FORMAT (515) 

140 PRINT 20, (II(J),J=1,5) 
150 20 F0RMAT(5I10) 

160 END 

RUN -.1- 


11111 22222 33333 44444 55555 

SRU 0.130 UNTS. 

RUN COMPLETE. 

SAVE,DEM0=TAPE1^After the SAVE command is read, the 

reader is turned off. A copy of the 
program DEMO is made an indirect 
access permanent file with the name 
TAPEl. Then the reader is turned 
back on. 

These three lines of modification 
are read in from the tape without 
interruption. 

RESEQ,100,5 -After the RESEQ command is read, the 

reader is turned off. When rese¬ 
quencing is accomplished according 
to specifications, the reader is 

SRU 0.576 UNTS. turned back on. 


135 DO 1 1=1,5 - 

137 II(I)=II(I)+4444 
139 1 CONTINUE 
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LIST-*- 

00100 PROGRAM DEMO 
00105 DIMENSION 11(5) 

00110 READ 10, (II(J),J=1,5) 
00115 10 FORMAT(515) 

00120 DO 1 1=1,5 
00125 II(I)=II(I)+4444 
00130 1 CONTINUE 
00135 PRINT 20, (II(J),J=1,5) 
00140 20 FORMAT(5110) 

00145 END 


After the LIST command is read from 
tape, the tape reader is turned 
off. Then lAF lists the primary 
file which contains the previous 
modifications in resequenced 
format. When the listing is com¬ 
pleted, the reader is turned on 
again. 


rUN-«- 

? 1111122222333334444455555 


-rrr.After the RUN command is read in, 
the reader is turned off, and the 
modified program is executed. lAF 
prints the ? and then turns the 
reader on. The line of data is read 
in from the tape and the reader 
turned off. The data is processed 
and results printed. 


15555 26666 37777 48888 59999 

SRU 1.185 UNTS. 

RUN COMPLETE. 

REPLACE,DEM0=TAPE1 * . This last command is read in and the 

reader turned off. A copy of this 
revised version of DEMO replaces the 
old one that was made an indirect 
access permanent file under the name 
TAPEl. It is now the indirect 
access permanent file that is 
referenced by the name TAPEl. 

The reader is turned back on. It 
runs through the trailer of rubouts 
and then turns Itself off. 

If, at this point, you have no more 
tapes to run, exit tape mode by 
entering the TKMDEF,IN=KB command. 
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MASS STORAGE DEVICE STATISTICS 


N 


The mass storage devices supported by the system and the size of blocks allocated for direct 
access files are as follows: 


Device 



Block Size 


Code 

Device 

PRtJs 

CM Words 

Characters 

DB-n 

885-42 Disk Storage Subsystem 
(l<n<3) 

n*640 

n*40960 

n*409600 

DC-n 

895-1/2 Disk Storage Subsystem 
(l^n<,2) 

n*704 

n*45056 

n*450560 

DD-n 

834 Disk Storage Subsystem 
(lin<8) 

n*160 

n*10240 

n*102400 

DE 

Extended Memory 

16 

1024 

10240 

DF-n 

887 Disk Storage Subsystem 
(l<n<3; 4K sector) 

n*608 

n*38912 

n*389120 

D6-n 

836 Disk Storage Subsystem 
(l<n<3) 

n*564 

n*36096 

n*360960 

DH-n 

887 Disk Storage Subsystem 
(l<ni2; 16K sector) 

n*704 

n*45056 

n*450560 

Dl-n 

844-21 Disk Storage Subsystem 
(half-track; l<n<8)t 

n*107 

n*6848 

n*68480 

DJ-n 

844-4x Disk Storage Subsystem 
(half-track; l<n<8)t 

n*227 

n*14528 

n*145280 

DK-n 

844-21 Disk Storage Subsystem 
(full-track; l<n<8)t 

n*112 

n*7168 

n*71680 

DL-n 

844-4x Disk Storage Subsystem 
(full-track; l<ni8)t 

n*227 

n*14528 

n*145280 

DM-n 

885 Disk Storage Subsystem 
(half-track; l<n<3)t 

n*640 

n*40960 

n*409600 

DN 

9853 Disk Storage Subsystem 

1120 

71680 

716800 

DP 

Distributive Data Path to 

16 

1024 

10240 


Extended Memory 


t Half-track is a recording mode that accesses alternate PRCs during a disk revolution; full- 
track recording mode accesses consecutive FRUs. Half-track mode needs two revolutions to 
access all PR0s on a physical track; full-track mode needs only one revolution. 
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Device 

Code 

Device 

PROS 

Block Size 

CM Words 

Characters 

DQ-n 

885-11/12 Disk Storage Subsystem 
(full-track; l<n<,3) 

n*640 

n*40960 

n*409600 

DV 

819 Disk Storage Subsystem 
(single density) 

400 

25600 

256000 

DW 

819 Disk Storage Siibsystem 
(double density) 

800 

512D0 

512000 

EA-n 

5830 Disk Array Siabsystem; 

One 5832 SSD drive used in 
serial mode (lin<8) 

n*160 

n*10240 

n*102400 

EB-n 

5830 Disk Array Subsystem; 

Two 5832 SSD drives used in 
parallel mode (l<n<6) 

n*320 

n*20480 

n*204800 

EC-n 

5830 Disk Array Subsystem; 

One 5833 SABRE drive used in 
serial mode (l<n<2) 

n*992 

n*63488 

n*634880 

ED-n 

5830 Disk Array Subsystem; 

Two 5833 SABRE drives: one 
for data and one for parity 
(l<n<2) 

n*992 

n*63488 

n*634880 

EE 

5830 Disk Array Subsystem; 

Two 5833 SABRE drives used in 
parallel mode. 

n*1920 

n*122880 

n*122880 

EF 

5830 Disk Array Subsystem; 

Three 5833 SABRE drives: two 
for data and one for parity. 

n*1920 

n*122880 

n*122880 

this table, 

n indicates the unit count for multiunit devices 

^u:ld X is 1 

or 4 . 


If your validation permits (refer to LIMITS Cranmand, section 7), the maximum size of an 
indirect access file is the device limit less the space allocated for catalog information and 
other files. 

The size of a direct access file is limited by the device and by your validation. There are 
no other system limitations. 
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INTERACTIVE TRANSFER FACILITY (ITF) 


O 


ITF allows you to connect your interactive terminal to a remote CYBER 200 computer system 
linked to your host mainframe by a loosely coupled network (LCN). If you want to submit 
batch jobs or want to retrieve or otherwise manipulate permanent files, you can use the 
Interactive Facility (lAF) (refer to Submitting Jobs to Remote hosts in section 3). 


SELECTING THE ITF APPLICATION 

You select the ITF application in the same manner as you would any Network Access Method 
(NAM) application, such as lAF or RBF. You specify ITF for the application name during 
login to NOS. If you are logged into lAF, you can switch to ITF by specifying ITF on the 
BYE, GOODBYE, HELLO, LOGIN, or LOGOUT command. 


SELECTING A REMOTE CYBER 200 SYSTEM 

Once you select ITF, you receive an ITF banner at your terminal. The following is an 
example of the two-line ITF banner: 

ITF 1.0 - psr level 
TERMINAL T103, CONNECTION 12 

Your site may automatically connect you to a remote host. If you are not automatically 
connected to a remote host, ITF prompts you for the logical identifer (LID) of the remote 
host you want to access. 

The LID is a three-character name your site has associated with that remote host. The 
prompt has the following form: 

ENTER LID (OR ?); 

In response to this prompt, enter one of the following: 

Entry Description 


lid Specifies the three-character LID your site has associated with 

the remote host you are attempting to reach. 

? Requests a list of acceptable entries. 

carriage return Selects the default LID as defined by your site. 

If the connection to the remote host cannot be established (for example, you enter an 
invalid LID), ITF so informs you. Unless otherwise directed by your site, ITF will then 
prompt you again for a LID. Your site may automatically switch you to another application, 
such as lAF, instead of prompting you for another LID. 
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If ITF establishes a connection to the remote host, it displays the following status message: 
ITF, CONNECTED TO HOST pid ON ACN n/TCN m 

where pid is the physical identifier (PID) of the remote host and n and m are connection 
numbers used by the system. Sometimes the PID is identical to the LID you specify. 


PROCESSING YOUR JOB ON THE REMOTE CYBER 200 

Once your terminal is under the control of the remote host, it gives you the following login 
prompt: 

ENTER CYBER 200 LOGON 

You can then log in and proceed with your interactive job. All of your terminal input is 
transmitted to the remote host and all data from the remote host is displayed at your 
terminal. You have the following limitations. 

• You cannot use transparent input mode (that is, do not enter the IN=X, IN=XK, or 
IN=XP terminal definition command). 

• Input lines longer than 999 characters are truncated without a comment. 

• The termination sequence (user break 2) disconnects your terminal from the remote 
host. 

To terminate your CYBER 200 job and disconnect from the remote host, enter the $BYE command. 


TERMINATING YOUR ITF SESSION 

Your site may automatically connect you to another application, such as lAF, any time you 
disconnect from the remote host. If not, your terminal returns to the control of ITF. ITF 
then prompts you for another LID. To end your ITF session, enter one of the following: 

Entry Description 

bye Ends your ITF session and logs you out of NOS. 

BYE, application Ends your ITF session and switches you to the specified 
application. The following are some valid applications; 

application Description 


lAF 

Interactive Facility 

MCS 

Message Control System 

PLATO 

PLATO-NAM Interface 

RBF 

Remote Batch Facility 

TAF 

Transaction Facility 

TVF 

Terminal Verification Facility 
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SAMPLE ITF SESSION 


The following is an example of an ITF terminal session: B2C is the LID of the 
remote CYBER 200 computer system: 


WELCOME TO THE NOS SOFTWARE SYSTEM. 

COPYRIGHT CONTROL DATA 1978, 198X. 

YY/m/DD. HH.HM.SS. T19A11 

CDC NETWORK OPERATING SYSTEM NOS 2 

FAMILY: ,usernam,passwrd,itf 

ITF 1.0 - psr Level 

Terminal T19A11, Connection 2 


ENTER LID (OR ?); b2c 

CITF, connected to host B2C on ACN 1/TCN 2.1 
PLEASE ENTER CY200 LOGONLogon 111111 a 99999999 
OS 2.1 RSYS21L1 VSYS21L1 I 09837.0412 ACTVE NONE 

NIL 

WARN1NG***ATTACHED POOLSfiles. 

NAME D OWNER SUF ACS TYPE DT FC BT RT FO ORI.DATE LEN UNIT 

12FILES *L0CAL A XR PD MS S C U S YY/MM/DD 00228 OE 

ALL DONESbye 
BYE 

CITF, terminal connection ended by host B2C.] 

ENTER LID (OR ?):bye 
ITF, CONNECT TIME 00.01.15. 

LOGGED OUT. 
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FILE TRANSFERS USING XMODEM 


P 


XMODEM is an industry standard communications protocol used to transfer files between CYBER 
mainframes and microcomputers. With XMODEM you can upload and download binary files as well 
as ASCII text files. To use XMODEM, the microcomputer communication software must use the 
Christensen protocol. 


XMODEM COMMAND 


The XMODEM command initiates the file transfer between NOS and microcomputers. Certain 
parameters must be specified on the XMODEM command or XMODEM prompts for them. Other 
parameters, if not specified, are given default values. 

You can define a configuration file (described later in this appendix) to change the default 
values for many of the command parameters as well as terminal characteristics. Some of the 
default values normally used by XMODEM can be superseded by values specified in your 
configuration file. If a value is specified in the command and in the configuration file, 
the command value supersedes the configuration file value. 

Format; 


XMODEM,FN=fn,TD=td,FT=ft,LF=lf,SP=sp,EC=ec,FM=fm,CF=cf. 
or 

XMODEM,fn,td,ft,lf,sp,ec,fm,cf. 


PaEjameter 

FN=fn 


TD-td 


FT=ft 


Description 


Name of the file to be transferred. The file to be transferred from 
the CYBER to the micro may be local or permanent. If the file is not 
specified, XMODEM prompts for the file name. 

Transfer direction. If TD=S is specified, the file is sent from the 
CYBER to the micro. If TD=R is specified, the file is sent from the 
micro to the CYBER. If this parameter is not specified, XMODEM 
prompts for it. 

File type. If this parameter is not specified, XMODEM prompts for it. 

A Specifies a 6/12-bit display code text file on the CYBER to or 
from 8-bit ASCII on the siicro. 

C Specifies a 6-bit display code text file on the CYBER to or from 
8-bit ASCII on the micro. 

E Specifies a 7-bit ASCII code text file on the CYBER to or from 
8-bit ASCII code on the micro. 

T Specifies a text file. XMODEM uses the current character code set 
mode of your CYBER job. 
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Parameter 


Description 


LF-lf 


SP=sp 


EC=ec 


FM=fm 


CF=cf 


B Specifies a CYBER binary file. 

M Specifies a micro binary file. 

S Specifies automatic selection (receive only). Special characters 
in the first block .determines the file type. 

This parameter determines whether an end-of—line on text files sent to 
the micro is transmitted as carriage return and line feed (LF=YES) or 
only as a carriage return (LF=NO). Default is LF=YES. The defaxilt 
value may be changed with the configuration file (refer to 
Configuration File in this appendix). 

This parameter determines whether or not the first block transmitted 
is a special file type block. The default is SP=NO. If SP=YES is 
specified, the special block is transmitted. The default may be 
changed by the configuration file. For more information on the SP 
parameter, refer to Limitations and Considerations in this appendix. 

Error checking (CRC or CHECKSM). The receiver determines the error 
checking mode. If TD=S is specified, the micro determines whether to 
use CRC or CHECKSM. Default is EC=CRC. 

File markers. FM may be set to NOS, CPtl, or MSDOS. FM determines 
which file markers are recognized or transmitted in text files by the 
CYBER. This parameter has no effect on the binary files. 

If FM=NOS is specified, #EOR, #EOF, and #EOI are recognized or 
transmitted to Indicate end-of-record, end-of-file, and 
end-of-information, respectively. If used, a four-character file 
marker must appear as the first and only marker on the line. 

If FM=CPM or FM*MSDOS is specified, end—of—records and end—of—files 
are Ignored on the text files transmitted from a CYBER to a micro. 

The end-of-information is transmitted as a CTRL/Z character. On files 
received from a micro, KMODEM recognizes a CTRL/Z character as the 
end-of-information. #EOR, #EOF, and #EOI are still recognized. 

FM=N0S is the default. The default may be changed with the 
configuration file (refer to Configuration File in this appendix). 

Configuration file. This optional parameter specifies the name of a 
configuration file. The specified configuration file restores your 
terminal characteristics after an XMODEM file transfer. 

When the CF parameter is used, XMODEM accepts the values for certain 
command parameters and terminal characteristics from the specified 
configuration file. The format and contents of the file are discussed 
in the Configuration File section of this appendix. The configuration 
file may be local or permanent. Default is CF-PFTFCFG. 
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USING XMODEM IN PROMPTING MODE 


Type in the coumand: 

XMODEM 

You will receive the prompt: 

HOST TO SEND (S) OR RECEIVE (R) A FILE? 

Enter S to send a file from the CYBER to a micro, or R to receive a file from a micro. You 
may enter the entire words SEND or RECEIVE. 


SENDING A FILE FROM A CYBER 

If you selected the transfer direction of SEND, the next prompt will be: 

PLEASE ENTER THE FILE NAME. 

The file you specify must be a local or a permanent disk file. If the file is empty or 
cannot be read, the file name prompt is repeated. 

XMODEM will then ask: 

Is the file - 

B - Cyber binary 
M - Micro binary 

T - Text — Display code (upper case only) 

A - Text — 6/12 Display code ASCII (upper/lower case) 

E - Text -- 8/12 ASCII 

After you select a valid option, XMODEM will print the approximate number of blocks to be 

transferred and indicate that it is ready to start the transfer. At this point, you should 

enter the appropriate commands on the micro to initiate the file transfer. 

XMODEM on the CYBER will acknowledge an ASCII NAK, a capital C, or an ASCII CAN (CTRL/X). 

If a NAK is received by the CYBER, the file transfer takes place using the checksum method 
of error checking. If a capital C is received, the error checking is done using CRC method 

of error checking. If a CTRL/X is received, the transfer aborts, and you are back at the 

NOS command prompt. 

If 10 characters are received and none are among the expected three, the transfer aborts 
with the error message: 

NO INITIAL NAK RECEIVED. 

If a CTRL/X is received at any time during-the transfer, the transfer aborts. 
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RECEIVING A FILE FROM A MICRO 


If you elected to receive a file from a micro, XMODEM prompts: 

PLEASE ENTER THE FILE NAblE. 

Enter the local file name under which you wish to have the file stored on NOS. If the file 
name is invalid or you cannot write to it, XMODEM repeats the prompt. 

Next, you are asked: 

Is the file - 

B - Cyber binary 
M - Micro binary. 

T - Text — Display code (upper case only) 

A - Text — 6/12 Display code ASCII (upper/lower case) 

E - Text — 8/12 ASCII 
S - Auto-select file type 

After you select a valid option, you should enter the micro commands necessary to start the 
transfer. XMODEM on the CYBER sends out an ASCII NAK or capital C (depending on the value 
set for the command parameter EC) until it either receives a block from the micro or has 
tried 10 times to initiate the transfer. After 10 tries, XMODEM aborts. 

If a CTRL/X (ASCII CAN) is received as the first character in a block, XMODEM aborts, and 
you are back at the NOS command prompt. 


CONFIGURATION FILE 

XMODEM can accept the values of some parameters from a configuration file. With this file, 
you can change the default values for parameters LF, SP, EC, and FM. You can also reset 
certain terminal characteristics. 

These are the rules for the configuration file entries: 

• One parameter entry per line is allowed. 

• Uppercase and lowercase characters may be used. 

• Blanks are not significant. 

• Lines beginning with an asterisk (*) are considered as comment lines. 

• Each line may optionally be terminated by a period. 

• Comments may follow the period on the same line. 
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The following are the parameters you can specify: 


Keyword 

Possible values 

Description 

LF 

YES, NO, Y, N 

Line feed issued after carriage return. 
Default is YES. 

SP 

YES, NO, Y, N 

Special file type block issued. Default is, 
NO. 

EC 

CRC, CHECKSM, CR, CM 

Error checking. Maximum parameter length 
is 7 characters. Default is CRC. 

FM 

NOS, CPM, MSDOS, N, C, M 

File marker type. Default is NOS. 

PA 

NONE, EVEN, ODD, ZERO, 

N, E, 0, Z 

Value to which parity will be reset upon 
termination of XMODEM file transfer. 

Default is NONE. 

EP 

YES, NO, Y, N 

Echoplex value set at termination of file 
transfer. Default is NO. 

IC 

YES, NO, Y, N 

Input flow control reset value. Default is 
YES. 

OC 

YES, NO, Y, N 

Output flow control reset value. Default 
is YES. 

AC 

decimal number 

Attention character (affects CDCNET 
terminals only). Refer to the CDCNET 
Terminal Interface Usage Manual. 

Example: 



EC = CRC. 

Set error checking. 



SP = NO. 
LF = Y. 
EP = N. 
OC = Y. 
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FILE TRANSFER NOTES 


There are three types of files that can be transferred: text files, CYBER binary files, and 
micro binary files. The processing of file markers and carriage control indicators (line 
feed, for example) depends on the type of file being transferred and the direction of 
transfer. 


TEXT FILES 

Text files have either an ASCII carriage return or a carriage return and a line feed 
appended to the end of each line when transferred from a CYBER to a micro. 

When a file is transferred from a micro to a CYBER, carriage returns are translated into 
zero byte terminators, and an ASCII line feed is ignored if it immediately follows a 
carriage return. If the FM=CPM or FM=MSDOS parameter is specified, XMODEM recognizes a 
CTRL/Z character as the end-of-information and also recognizes #EOR, #EOF, and #EOI file 
markers. If FM=NOS is specified, XMODEM recognizes or transmits #EORs, #EOFs, and #EOIs. 

To be recognized, a 4-character file marker must appear as the first and only characters on 
a line. 

If a file received by the CYBER is transferred as a display code text file (uppercase only), 
lowercase alphabetic characters are translated as uppercase. Untranslatable characters are 
set to asterisks (*), except for the ASCII NULL character, which is ignored. 


CYBER BINARY 

A CYBER binary file is transferred eight bits at a time. The file is blocked during 
transmission, with the first character being the length of the block or an EOR/EOF/EOI 
marker. If an EOR/EOF marker is found, the next character is again a block length or an 
EOR, EOF, or EOl. The maximum block size is 240 (decimal). A value of 253 indicates an 
EOR, 254 Indicates an EOF, and 251 indicates an EOI. Only files that are transferred from a 
CYBER to a micro as CYBER binary files can be transferred from a micro to a CYBER as CYBER 
binary files, otherwise unpredictable results can occur. 

/ 

Any data received by the CYBER after the EOl marker is received is acknowledged but 
discarded. 


MICRO BINARY 

A micro binary file received by the CYBER is stored as 8/12-bit ASCII. Each 8-bit ASCII 
character received is stored on the CYBER as a 12-bit ASCII character with the high order 
bit set. When the file is transmitted back to the micro, any zero character is ignored. 
Thus, a NULL character must be represented as 4000B. The high order bit is optional on all 
other characters. A file processed by FCOPY meets these requirements, except that end of 
lines (since they are zero) are Ignored. This method is necessary to guarantee that the 
file is sent back to the micro exactly as it was received. 
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LIMITATIONS AND CONSIDERATIONS 

The following are general tips on using XMODEM: 

• Since the XMODEM protocol is an 8-bit protocol, parity must be set to NONE. XMODEM 
internally Issues a TRMDEF,PA=N. However, data networks such as local area networks 
may force a specific parity. Such networks must be configured for transparent data 
transmission. If they are configured to force parity other than NONE, XMODEM will 
not work. The communications path must be capable of transmitting all 256 ASCII 
characters. 

• Echoplex must be set to OFF (EP=N). If EP=Y is set, each character sent to the 
CYBER is echoed back, and the micro cannot distinguish between echoed data and real 
data transmitted by the CYBER. XMODEM internally turns echoplex off. As there is 
no way for XMODEM to determine the current setting of echoplex, it normally leaves 
it off after the transmission. This can be altered by using the configuration file 
(described earlier). Some data networks may echo data themselves, rather than 
having the CYBER front end echo the data. XMODEM cannot disable this echoing. You 
must disable the echoing. 

• Some micros, such as the APPLE.i" require the high order bit in each character to 
be set for some files. This is also true of some word processors, such as 
WORDSTAR. If the file is transferred as a 6/12-bit display code text file to the 
CYBER, the high order bit is lost because these character sets do not support all 
256 ASCII characters. To get around this problem, you can either write a program on 
the micro to restore the high order bit, or you can transfer the file to the CYBER 
as an 8/12—bit ASCII file, or as a micro binary file. 

• If the SP parameter is set to YES, the first block transmitted from the CYBER to the 
micro is of this form: 

SOH+200B/filetype/255D-flletype/123D/zeros 

Where SOH is an ASCII SOH, and file type is 

00 - Text 

04 - Micro binary 

08 - Cyber binary 

The 123 is included to ensure that the checksum does not match so that micros which 
do not recognize this block will respond with a NAK (Negative Acknowledge). This 
block is recognized by ASCII Expresstt for the Apple. If the special block is not 
supported by your micro's transfer program, it will be considered an invalid block 
and will be NAKed. If this block is NAKed three times, the transfer will proceed 
with the data. 

If the first block received by the CYBER is of this form and the file type was set 
to auto-select, the file type in the block is used to determine the file type used 
for the transfer. If an invalid file type is detected, micro binary file is used. 

If the auto—select mode is set and no special file type block is received by the 
CYBER, a file type of TEXT with 6/12—bit display code is used. 


tA registered trademark of Apple Computer, Inc. 
ttA registered trademark of United Software Industries, Inc. 
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• Although the CYBER implementation supports most common extensions to the XMODEM 
protocol, it does not support batch mode. If you try to transfer files using batch 
mode, the transfer terminates. 

• As input timeout has not been implemented in NOS, XMODEM does not timeout after 10 
seconds and does retransmit the last block. The protocol requires the receiver to 
timeout, but the sender may not always timeout. This causes problems only when the 
micro is the sender and the micro does not timeout. Most XMODEM packages available 
for micros timeout in both directions; so this limitation will not normally cause 
any problems. 
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AAM (See Advanced Access Method) 

AB command J-5 

Abbreviated job status command 8-17 
Abort C-l 

Abort output character 16-5; J-5 
Aborting output 16-5 

ABS record type 15-4,6 

Absolute binary card output F-7 
ACCESS command 8-12 
Access level C-l 
Access level, equipment C-4 
Access subsystem 8-12,20.1,37 
Account block 3-11, 704,59,63; C-l 
Account dayfile 3-18; 7-4 
Accoxmting for system resouces 3-8; 7-4 
Accumulated central processor time 
3-18; 7-10,17 
ACF record type 15-3 
Adder activity 3-18 
Address out of range error 6-23 
Advanced Access method (ARM) 1-6 
AEMP (See Matrix Array Processor (MAP), 
resource usage) 

AESR (See System Resource Unit (SRU)) 

AFTER directive 15-27 

Allocatable device C-l 

Alphanumeric C-l 

ALTER commeind 8-42 

TVltemate storage 2-15,16 

ANSI labeled tapes 2-8.1; 12-9,14,19; G-1 

ANSI X3.64 standard terminal 16-1; J-25 

APPEND command 10-7 

APPEND mode 10-8 

Appending files 10-7 

implication C-l 

Application, resource usage 3-18 
implication switching 3-5; 8-18,19,21; 

C-l; J-2 

APPSW commemd 8-18,19 
AR command j-5 
ARG= entry point 15-43 
Argviment C-l 
ASCFL code 9-23 
ASCII C-l 

ASCII code set 9-23; A-1,12 

ASCII commeuid 8-2; A-3 

ASCII graphic character sets A-l 

ASCII graphic 63-character set A-l,2 

ASCII graphic 63/64-character set 9-46; A-l 


ASCII graphic 64-character set 9-48; 
A-l.2,3 

ASCII graphic 95-character set 9-46,48; 
A-l,2,3 

ASCII mode 8-2,4; A-3; E-1 

ASCII 128-character set A-l,3 

ASCII, 7-bit code 9-23; A-l 

ASCII63 code 9-23 

ASCII64 code 9-23 

ASCII8 code 9-23 

ASCII88 code 9-23 

Assembler language 1-5 

ASSIGN command 2-15; 9-2; 12-5 

Asynchronous terminal output 16-5 

Asynchronous terminals J-4 

ATTACH command 10-8 

ATTN key, IBM 2741 terminal 16-8 

ADTO commcuid 8-3 

Auto-drop status 9-56 

Auto eject mode H-2 

Auto mode 8-3 

Automatic line spacing H-2 

Auxiliary device 2-15,16; 10-4,35; C-l 


B format tapes 9-59; I-l 
Backspace character 16-3; J-7 
BAM (See Basic Access Method) 

Banner page 9-54,55; D-2 
BASIC C-l 

Basic Access Method (BAM) 1-6 

BASIC command 8-12 

BASIC subsystem 8-12 

BATCH command 8-13 

Batch job 3-1 

Batch subsystem 8-13 

BCD code A-12 

BEGIN command 4-41,53; 6-16.3 

Beginning-of-information (BOI) 2-3,4; C-2 

BF command J-6 

Binary card F-15 

Bieuiry dun^ 11-1 

Binary file 15-14 

Binary input mode K-1 

Binary mode 2-7,8; 9-7 

Bisynchronous terminals J-4 

Bit C-2 
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1-2; 7-7 


BKSP cottunand 9-4 

BKSPRU command 9-4.1 

BLANK command 12-9 

Bleuak label, magnetic tape 12-9 

Block C-2 

BLOCK command 7-2 

Block count G-8,9 

Block mode J-18 

Block size 12-14; N-1 

Block size, terminal input J-6 

Blocking factor J-6 

BOI (See Beginning-of-information) 

BR commeuid J-6 

BREAK key 16-5; J-6 

BRIEF command 8-4 

BS command J-7 

BUFFER OUT Statement, FORTRAN 2-7 
BYE command 3-4; 8-19 
Byte C-2 
B1 command J-7 

B2 commcuid J - 8 


Cancel character J-9 
Cancel line character 16-4,5 
CAP record type IS-3,15 

Card, binary F-1,5,6 
Card, coded P-1,3 
Card deck, physical file structure 
2-5,6 

Card file 2-6 

Card file data conversion F-1 

Card formats F-2 

Card punch 1-4 

Care, punch format P-1 

Card reader 1-4 

Cards punched, record of 3-19 

Carriage control array H-7 

Carriage control characters H-2,3,4,5 

Carriage control tape H-4.2 

Carriage return J-12,13; K-l 

Carriage return function 16-3 

Catalog C-2 

CATALOG command 15-3,5 

Catalog track 2-7 

CATLIST command 8-28; 10-3,10 

■CC directive 4-33 

CCP (See Communications Control Progreim) 
CCCCCCO file 13-1 
CDCNET 3-2; 8-9; 16-1 
CDCNET network 8-10 

CEJ/MEJ (See Central/Monitor exchange jump) 
Central library directory 5-5 
Central memory allocation 1-3 
Central memory (CM) 1-2 
Central memory dump 11-1,5,7,9,10 
Central memory resident (CMR) 1-3 
Central memory time slice 3-12 
Central processor time, accumulated 


3-18; D-4 

Central processor unit (CPU) 

CFO cconmand 7-3 
CH eexmnand J-8 
CHANGE command 10-15 
Character C-2 
Character code set conversion 9-23; A-1 
Character conversion E-1 
Character echoing J-14 
Character input mode K-l 
Character set 

Anomalies A-2 

ANSI standard A-l 
ASCII A-l 

ASCII graphic 63-character set A-l 
ASCII graphic 64-character set 9-48; 
A-l 

ASCII graphic 95-character set 9-48 
A-l 

ASCII 128-character set A-l 
Batch job A-2,3 7 

Control Data graphic 63-character 
set A-l,3 

Control Data graphic 64-character 
set A-l,3 

Conversion for magnetic tapes 9-23; 

A-12 

Definition A-l 

Interactive job 8-2,6.2; A-2,3,5 
NOS-supported A-l 

Recognition J-5 
Character set mode 8-4 
CHARGE command 7-4,69 
Charge number 7-4 
Checkpoint 9-38; 13-1; C-2 
Checkpoint dump 13-1,3 

Checkpoint file 9-38; 12-8,14.1; 13-1; C-2 

Christensen protocol P-1 

CHVAL command 7-5 

Cl command J-9 

CKP command 13-1 

CLASS command 7-7 

CLEAR comand 9-5 

Clock cycle count 7-22.1 

CM (See Central memory) 

CMR (See Central memory resident) 

CN command J-9 

COBOL, RECORDING MODE IS BINARY statement 
2-7 

COBOL, RECORDING MODE IS CODED statement 
2-7 

COBOL, sign overpunch convention A-2 
Code set 

ASCII A-l 
Conversion 9-23; A-l 
Definition A-l 
Display code A-l 
NOS-supported A-l 

6-bit display code 8-2,6.2; A-l 
6/12-bit display code 8-2,6.2; A-l 
Code set conversion 9-23; A-10 
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Coded Ccu:d conversion F-4 

Coded card output F-6 

Coded file 9-13,51 

Coded line 2-7 

Coded mode 2-7; 9-7 

Colon, code set representation A-2 

Colon representation F-l 

Command 

Continuation line 5-2 
Format 5-2,3 

Interactive status 8-16 
l&iltiple entry 7-21 
Prefix character 5-2 
Processing 5-1 
Syntax 5-2 

Terminator 5-2 
Terminator chsuracter 5-3 
Commauid processing 

Dollar ($) prefix 5-2 
Operating system format 5-2 
Product set format 5-2 
Sepaurator characters 5-2 
Slant (/) option 5-2 
Terminator character 5-2 
Command processing flow 5-5 
Command record 

Job 3-1; C-2 
Procedure 4 -3,4,5 

Ccmmands 

File maintenance 14-1 
Global library file 5-1 
Iterative G-31 
Load/dunp memory 3-13 
Local file 5-1 
Primary file editing 5-2; 8-39 
Product set 5-1 
Protected 3-13 
Skipping 6-17,18,19,30 
Subsystem selection 8-11 
System 5-1 
Tape management 12-1 
Terminal definition J-1 
COMMEKT ccxnmand 7-9 
Ccxnment (*) directive 4-40.2 
Ccxnment (*/) directive 15-20.1,31 
COMMOH command 10-16 
Communications Control Prograun (CCP) 
3-2; 16-1; J-1,2 
COMPASS 1-5; 7-39 
COMPASS ccm^ressed output 9-26 
Ccm^ile C-2 
Conpiler lauiguage 1-5 
Conpressed output, COMPASS 9-26 
Connect time 3-4 
Connection status 6-7 
Constamts 6-5 

Continuation line, commamd 5-2 
Control byte 16-9 


Control character C-2 


Control character, character set A-1 
Control point C-3 
Control registers 6-8 
Control registers, flow control ccsnmand 
6-25; 7-16 

Control statement C-3 
Conversion, code set 9-23; A-10,12 
Conversion mode F-3 


Conversion mode, MT, CT, AT tape 

COPY command 2-7; 9-5 

COPYBF commatnd 9-11 

COPYBR commamd 9-12 

COPYCF ccmmand 9-13 

COPYCR ccmmamd 9-15 

COPYEI ccmmamd 9-16 


Copying files 

Binary mode 9-7 

Coded files 9-13,15,51 

Coded mode 9-7 


Multifile files 9-10,11 
Multirecord files 9-12 


12-7,14 


Octal cqpy 9-62 
Processing options 9-10,62 

Record replacement 15-7 

Tape files 9-59 
Termination 9-7,10 
Verification 9-10 
Copying records 15-7 
COPYL commamd 15-3,7 
COPYLM conmand 15-3,7 
COPYSBF commamd 9-J.7; P-2 
COPYX command 9-18 


•CORRECT directive 4-23 


Correspondence code 8-2 

CP command J-10 

CPU mode error 6-22 

CPU priority 7-64 

CPD (See Central processor unit) 

CPD time, accumulated 7-10,17; D-4 
CPU time limit 7-64 
CPDMTR 1-3 

CRH (See CYBER Record Manager) 

CSET command 8-4 


CT commamd J-10 

ct D command 8-16 

ct E ccmmand 8-17 

ct S command 8-17 

CTIHE command 5-5; 7-10 

CTRL/F character 16-6 

CTRL/P character 16-6 

CTRL/T character 16-6 

Cursor positioning J-10 

CYBER Control Language level 6-7,16 

CYBER loader 1-6; 7-60; 15-32,33; C-3 

CYBER Record Manager (CRM) 1-6; 2-2,3; 

9-1; 10-8; 15-1; C-3 
CYBER 200 Conputer System 3-6 
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Data blocks, network J-6 
.DATA directive 4-3,4,14,34.2 
#DATA value 4-14,34.2, L-1 
Database file 2-15 
Date 6-7 

Day of the week 6-7 
Dayfile 7-10; C-3; D-4 
Account 3-18 
Job 3-18 

DAYFILE command 7-10 
DCl J-18,21 
DC3 J-18,21 

DDF (See Distributive data path) 

Deadlock 7-50,52 

Deadstart C-3 

Debug mode 15-17 

DEC VTIOO terminal 16-1; J-25 

Default C-3 

Deferred batch jobs 7-68 
Deferred routing 9-35,44,45,46 
DEFI2^ commeind 10-17 

DELETE command 8-44 

Deleting input lines 16-4 

Delimiters for input K-1 

Detach command 8-16 

Detached interactive job 2-12; 8-16,30; C-3 
Device C-3 

Assignment 7-57 
Auxiliary 2-16; 10-29 
Family 2-15 
Hass storage 2-15 
Type 6-13,14,14.1; 7-51; 9-2; N-1 
DIAL command 8-20.1 

Direct access file 2-11,14; 10-7,17; C-3 
Directory 

Library 5-5 
Random access 15-24 
DIS code 9-23 
Disk Array Subsystem C-3 
Disk, auxiliary 7-51,52,57 
Disk physical file structure 2-5 
Disk storage subsystems 1-4; N-l 
Display code C-4 

Display code, 6-bit 8-2; 9-23; A-1 

Display code, 6/12-bit 9-23; A-1 

DISPLAY ccmimand 6-16.4 

Disposition code C-4 

Disposition code, ROUTE commeind 9-44 

Distributive data path (DDF) 1-4; N-l 

DIS63 code 9-23 

DIS64 code 9-23 

DL ccxnmand J-ll 

DMB command 11-1 

DMB extended memory error 11-4 

DHB output 11-3 

DHD command 11-5 

DHDECS command 11-6 

DHF command 11-6.1 

DHFECS command 11-7 


DOCHENT ccxnmand 9-20 
DROP ccxnmemd 7-12.1 
DROPDS ccxnmand 10-20 
Drc>pping jobs 7-12 
DT function 6-14 
Dual processors 3-18; 7-64 
Dual-state, NOS/VE 3-5 
Dunp 9-62; 10-33 

Central memory 11-1,5,6.1,9,10 
Checkpoint 13-1,3 
Bxcdmtnge pacdcage 11-1,5,6.1 
Extended memory 11-1,6,7 
Field length 11-1 
Dusp memory commands 11-1 
DUP ccxnmand 8-45 


E format tapes 9-59; 1-2 
EB ccxnmand J-12 
EBCDIC code A-12; C-4 

EBCFL ccxie 9-23 
Echoing J-14 
Echoplex mcxle J-14 

ECS (Extended Core Storage; See Extended 
Memory) 

EDIT ccxnmand 14-1 

BEA (See Error exit address) 

EFFECT command 8-4 

EL ccxnmand J-13 

ELSE ccxnmand 6-17 

.ELSE directive 4-4,38 

BLSEIF ccxnmand 6-18 

.ELSEIF directive 4-38.1 

Empty PR0/record C-4 

End-of-block character J-12 

End-of-file (EOF) 2-3,4; 9-51; C-4; F-2 

End-of-file label 6-1,8,10 

End-of-information (EOI) 2-3,4; C-4; F-2 

End-of-line F-2; H-1; K-1 

End-of-line byte A-2; F-1 

End-of-line character J-13 

End-of-record (EOR) 2-3,4; 9-51; C-4; F-2 

End-of-reel 1-3 

End-of-t^ (EOT) 12-4,5; C-4; G-1; 1-3 

End-of-volume label 6-1,9,10 

.ENDHELP directive 4-24 

BNDIF ccxnmand 6-18.1 

.ENDIF directive 4-4,39 

ENDW ccxnmand 6-19 

.EHDW directive 4-40.1 

ENQUIRE command 2-12; 7-13; 9-50 

ENTER command 7-21 

.ENTER directive 4-24 

Entry point, definition C-4 

Entry point, library directory 15-33 

Entry point listing 15-5,15 

.EOF directive 4-38 

EOF (See End-of-file) 

EOFn label 6-1,10 
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3-9; 7-40 


EOFl label 2-8.1,9; 12-9,11; G-8 

EOI (See End-of-information) 

-EOR directive 4-38 
EOR (See End-of-record) 

EOT (See End-of-tape) 

EOVn leUael G-1,10 

EOVl label 2-8.1,9; G-9 

EP ccmmand J-14 

Epilogue C-4 

Epilogue, project C-11 

Equipment access levels C-5 

Equipment status table (EST) 3-19 

ERRMSG command 7-22 

Error codes, system 6-9,10 

Error exit mode 6-22 

Error flag 6-8,25; C-5 

Error messages B-l 

Error processing 3-12; 5-7; 6-23 

EST ordinal C-5; D-4 

EST (See Equipment status table) 

EVFD load file H-2,4.2 

EVICT ccxnmamd 9-22 

.EX directive 4-9,39 

Exchange package 3-12; C-5 

Exchange package dunp 11-1,5,6.1 

Executable object code C-5 

EXECUTE command 8-13 

EXECUTE mode 10-8 

Execute subsystem 8-13 

Execution time 1-2 

EXIT command 3-12; 5-7; 6-19 

Exit mode 6-8 

Exit processing 5-7 

.EXPAND directive 4-6,33,34.2 

EXPLAIN command 8-20.1 

Extended instruction stack purging C-5 

Extended memory 

Description 5; 1-3; C-5 
Direct access files N-1 
Dun^ 11-1,6,7 
Error 11-4 

Field length 3-9; 7-25,39 
Library directory 15-33 
Preservation 7-44 
Extended stack purging 7-39 
External references, librau^r directory 15-33 


F tape format 2-10; 9-10 
FA ccmmand J -14 
Family 2-15; D-2 
Family device 2-15; C-5 
Family name 6-8.1; 7-74; C-5 
FCl 12-4; C-5 

FCOPY comaand 2-7; 9-23; A-12 
FET (See File environment t203le) 

Field length, extended memory (FLE) 3-9 
Field length (FL) 1-2; 3-9; 7-24,39,57; C-5 
Load/Dunp 11-1 

Field length, maximum (MAXFL) 3-9; 7-39 


Field length, rxinning (RFL) 

File 

i^end operations 8-51; 10-7 

Assignment to device 9-2 

Backspacing 9-4 

Backup copy 10-3 

Copying 8-51; 9-5,16,17,62; 15-7 

Copying lines 8-49,52 

Creation 2-12,13 

Creation date G-8,9 

Definition '2-1; C-5 

Device residence 2-7,15,16 

Editing 14-1,14,18 

Execution 8-35 

External characteristics 9-46 

External documentation 9-20 

Generation number G-8,9 

Information 15-5 

Internal characteristics 9-48 

Internal docimientation 9-20 

Listing record information 15-14 

Locked 9-26,65 

Logical 2-1,2 

Maintenance 15-7,11 

Organization 2-3 

Overwriting data 9-35 

Packing 9-36 

Physical structure, by device type 2-5 

Positioning 9-4,43,56,57,58 

Printed output formatting 2-12 

Printing 9-46 

Purging 10-31,32 

Reformatting 9-27 

Releasing 9-5,22,42,56,64 

Replacement 10-45 

Resequencing 9-40 

Retrieval 10-7,20,21,28 

Rewinding 9-43 

Routing 7-36; 9-31,35,44 

Simultaneous user access 10-8,9 

Sorting 9-40,58 

Status 7-15,27; 9-56 

Storing 10-45,46 

Structure 2-1 

Structure, CRH logical 2-3 

Pile 

Structure reporting 9-51 
Subdivisions 2-1,2,3 
Subsystem association 8-12; 10-5 
Terminology 2-3 
Transfer between mainframes 
9-31,49,50; 10-21 
Types 2-11 
Verification 15-35 
Verifying 9-65 

Pile access category 3-14; C-6 
File access level 3-14; C-6 
File access mode 2-14; 10-8,10 
File accessibility character, 
tape 12-10.1,10.2,15 
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File attribute 6-12 

File, binary 15-14 

File, card 2-6 

File catalogue 10-10 

File, checkpoint 9-38; 13-1 

File, coded 9-13,51 

FILE command, CKH 2-7 

File, database 2-15 

File, direct access 2-13,14; 10-7,17 

File directives 4-34.1 

File directory 15-1 

File environment table (FET) C-6 

File expiration date G-8,9 

FILE function 6-12,13 

File header label G-1,4,10 

File, indirect access 2-14; 10-7,20; C-7 

File information table (FIT) C-6 

File marks 2-5; 9-36,51,68 

File, mass storage 2-6,15 

File, multifile 2-3,4 

File name 2-1 

File name table (FNT) 5-5 

File password 10-4.1 

File, permanent 2-13,14; 10-10,15,45,46 

File permission mode 10-5,30 

File permit category 10-3 

File, primary 2-13; 9-37 

File, private 10-3 

File, program library 2-17 

File, public 10-3 

File, queued 7-45; 9-31,44 

File residence 2-15; 10-4.1,29 

File, semi-private 10-3 

File sequence number, tape 12-15 

File set C-6 

File, SYSTEM 10-16 

File, tenporary 2-12 

File treinsfers 10-23 

File types 2-11 

File, user library 2-17 

#FILE value 4-14; L-1 

FIT (See File information table) 

FL (See Central memory field length) 

Flag C-6 

FLE (See Extended memory field length) 

Flow control command 

Command descriptions 6-16.3 
Continuation lines 6-2 
Control registers 7-16 
Expressions 6-2 
Format 6-2 
Functions 6-12 
Operands 6-2 
(^erators 6-2 
Symbolic names 6-7,25 
Syntax 6-2 
.Fn directive 4-24.1 
FMT (See File name table) 

Format channel selection H-4.2 


Format controls, 580 line printer H-1 
Format effectors 8-4 
Forms code 9-47 
FORTRAN C-6 

FORTRAN, BUFFER ODT Statement 2-7 

FORTRAN command 8-14 

FORTRAN subsystem 8-14 

Frame C-6 

FSE command 14-2 

FTNTS command 8-15 

FTNTS subsystem 8“-15 

FTP Command 10-20.1 

FTP Directives 10-20.1 

APPEND_FILE Directive 10-20.2 
CHANGE_ADTO_LOGIN_MODE 
Directive 10-20.3 

CHANGE_BELL_MODE Directive 10-20.3 
CHANGE_DEBnG_MODE Directive 10-20.4 
CHANGE_FILE_NAME Directive 10-20.4 
CHANGE_INPDT_FILE Directive 10-20.4 
CHANGE_OCITPUT_FILE 
Directive 10-20.5 
CHANGB_PORT_COMMAND_MODE 
Directive 10-20.5 
CHANGB_TRANSFBR_TYPE 
Directive 10-20.5 
CHANGE_VERBOSE_MODE 
Directive 10-20.6 
CREATE_HOST_CONNECTION 
Directive 10-20.6 
DEFINB_ADTO_LOGIN 
Directive 10-20.7 
DELETE_PILB Directive 10-20.7 
DELETE_HOST_CONNECTION 
Directive 10-20.8 
DISPLAY_COMMAND_INFORMATION 
Directive 10-20.8 
DISPLAY_DIRECTORY 
Directive 10-20.8 
DISPLAY_FILE_NAMES 
Directive 10-20.9 
DI SPLAY_FTP_OPTIONS 
Directive 10-20.9 
DISPLAY_I,OCAL_HELP 
Directive 10-20.9 
DISPLAY_REMOTE_HELP 
Directive 10-20.10 
GET_FILE Directive 10-20.10 
IiOGIN_DSER Directive 10-20.12 
QUIT Directive 10-20.13 
REPIiACE_FlLE Directive 10-20.14 
SEND_FTP_COMMAND Directive 10-20.15 
Full-ASCII mode 8-2; a-14 
Full-duplex mode J-14 
Full Screen Editor (FSE) 14-2 
Batch mode 14-2 
Function keys 4-24.1 

.F7 directive 4-24.1 
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GE tape density 7-54 

Generation C-6 

GET command 10-21 

GID (See Record group identifier) 

Global error flag S-8,25 

Global library set 5-5; 6-13; 15-43; C-7 

GO cansDcuad 7-22 

GOODBYE command 3-4; 8-21 

Graphic C-7 

Graphic character A-l 

GTR command 15-3,11 

GTR directives 15-12 


HAD (See Host availability display) 
Half-duplex mode J-14 

Hardware, System 1-1 

HASP terminals 16-1; J-1,4,25 
HAZ terminal J-1 

Hazeltine 2000 terminal 16-1; J-1,25 

HC command J-15 

HD ccHtsnand J-15 

HD tape density 7-54 

HDRn label G-l,10 

HDRl label 2-8.1,9; 12-9,11,15; G-4 

HELLO commcuad 3-5; 8-21 

HELL07 command 3-5,6.1; 8-22 

HELP ccHisnand 8-26 

.HELP directive 4-25 

Help, online 8-26 

HELPHB command 8-26 

HHA (See Highest high address) 

Highest high address (HHA) 3-9 
HN command J-17 
Hollerith punch code F-3 
Hollerith punch output F-5 
Host C-7 

Host availability display (HAD) 

3-5; J-15,16 

Host node selection J-15,18 
HTIHE ccanmand 5-5; 7-22.1 


I format tapes 2-10; 9-10,59 
lAF (See Interactive Facility) 

IBM 2741 terminal 16-1,8; J-25 

IBM 2780 16-2; J-25 

IBM 3780 16-2; J-25 

IC command J-18 

.IC directive 4-34 

Idle characters J-9 

IF command 6-20 

IFE command (See IF command) 

.IF directive 4-4,40 
.IFE directive (See .IF directive) 
IGNORE directive 15-27 
Immediate job status ccxnmand 8-17 
In?>licit remote routing 9-48 
Implicit routing 9-50 
IN command J-18 


Indefinite operand error 6-23 

Indirect access file 2-14; 10-7,20; C-7 

Input data E-l 

Input device selection J-18 

Input disposition 2-11; 9-44 

Input file 2-11; 3-11; C-7 

INPUT, file 3-11 

Input flow control J-18 

Input line 

Correction 16-3 
Deletion 16-4 
Entry before prcmpt 16-4 
Length 16-3 
Termination 16-3 
Input prompt 16-4 
Input queue 2-11 
Input trcuasmission mode J-18 
INSERT directive 15-27 
Instruction stack purging 7-39; C-7 
Interactive command names 5-5 
Interactive Facility (lAF) 1-1; 3-2,4,6; 

7-32; 8-4,18; 16-1; C-7; J-1,25 
Interactive job 3-1 
Interactive job origin 3-6.2 
Interactive job subsystem 6-11 
Interactive status commands 8-1,16; 16-4 
Interactive Transfer Facility (ITF) 3-6; 

7-32; 8-18 

Interrecord gap C-7 

Interruption character 16-6; J-7 

Interruption sequence 16-4,6,7; C-7; J-6,7 

ITEMIZE command 15-3,14 

Iterative command 6-31 

ITF (See Interactive Transfer Facility) 


Job C-7 

Accumulated CPU time 7-10 

Checkpoint 13-1 

Conpletion 3-17 

Control 3-9 

Dropping 7-12 

Entry 3-1; 7-25,68 

Error processing 6-23 

Exit processing 5-7 

Field length 1-2; 3-9; 7-24,35,57 

Initiation 3-1 

Output 3-19; D-1 

Output processing 2-12; 7-62 

Remote routing 3-6; 9-31,44; 10-21 

Resource demand 7-14,51 

Resource usage 3-18; 7-17,59,64,67 

Restart 13-1 

Scheduling 3-9 

Scheduling priority 3-6.2 

Security 3-13 

Status 7-13,21,73; 8-17,31 

Summation of activity 3-18 

Suspension 7-62,63,65 

Termination 2-11; 3-1; 5-7; 7-62 
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Time limit 7-24 
Timeout period 3-4 
Job access category set C-7 
Job access level C-7 
Job card 7-23 
Job command 3-6.1; 7-23 
Job cooBBunication area 5-4 
Job control 

Command limit 3-11 
Error 3-12 
Input file 3-11 
Rollout 3-12 
SRU limit 3-11 
Time limit 3-11 
Job file 2-11 
Job input file 3-11 
Job, interactive 3-1 
Job name 3-7 

Job origin type 3-6.2; 6-7; D-2 

Job priority 2-12; 3-7,9; 7-23,24,64 

Job processing commands 8-18 

Job processing p^u^ameters 7-23 

Job, remote batch 9-50 

Job, rolled out 3-12 

Job scheduler 7-58 

Job sequence name (JSN) 3-6.2; 7-18; C-7; 

D-2 

Job service class 3-6.2 
Job step C-7 

Interruption sequence 16-6 
SRD limit 3-11 
Suspension 16-7 
Time limit 3-11; 7-64 
Job termination 2-11 
JSN (See Job sequence name) 

KEY command 8-5 

Keypunch conversion mode 2-6; F-3 
KRONRSF command 14-4 

L format tapes 2-10; 9-10; 12-2 
L tape format 2-7 
Label C-7 

ANSI G-l 

Magnetic tape 2-8.1; 12-11,19; G-l 
Optional G-l,10 
Required G-l 
0ser G-11 

LABEL command 2-7; 12-11 

Laibel standard level 12-10.2 

Labeled tape 12-7,14 

LBC command 11-8 

LCN (See Loosely coupled network) 

LDI command 7-26 
LEN function 6-16 
liENGTH command 7-27 
Iievel nimiber C-8 


LI command J-20 
LI format tapes 2-10; 9-10 
LIB ccanmand 8-26 
LIBEDIT conmand 15-3,17 
LIBEOIT directives 15-20 
LIBEDIT output 15-31 

LIBGEN commauad 15-28 
Library 2-17; 15-1; C-8 
Creation 15-17,34 
Global library set 15-43 
Maintenance X5-17,34 
Processing exaa^sles 15-37 
Program 14-5,8,14 
System 15-43 
User 15-33,34,43 
LIBRARY commeuid 15-43 
Library directory 

Entry points 15-33 
Extenal references 15-33 
Library file 2-13; C-8 
Library file type 2-11 
Libreuy maintenance 15-1 
Library record type 15-2,3 
Librau^r search order 15-44 
Library, user 15-1,33 
Structure 15-33 
LIBRARY, user name 2-17 
LID (See Logical identifier of mainframe) 
LIMITS conmand 7-28 
Line C-8 

Length 16-3 
Logical 16-3 
Physical 16-3 
LINE comoicuid 8-6.1 
Line feed J-12,13; K-1 
Line feed function 16-3 
Line feed idles J-20 
Line mode 8-6.1; C-8 
Line nusUsers 8-3,39; 9-40,58 

Line printer 1-4 

Auto eject mode H-2 

Carriage control characters H-2,3 

Character sets 9-47; A-3 

Paper size H-1 

Print trains A-3 

Punched tape loop H-4 

533/536 9-48; A-4; H-1 

580 H-1,4 

585 9-48 

Line printer carriage control H-1 
Line sequence number 9-40 
Line speed recognition J-5 
Lines printed, record of 3-19 
Lines printed, total 3-19 
Linked host 7-36 
LIST command 8-28,46 
LIST directive 15-28 
Listing record information 15-14 
Listing tape labels 12-19 
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LISTLB ccoimand 12-X9 
LISTLID ccsnmeuid 7-36 
LISTS0 command 9-26 
Literal card input F-3 
Literal string 5-3; 6-5 
LK conmand CT-20 

Load/diat^) memory commands 3-13; 11-1 

Load point C-8 

Loader information 7-16 

Loading 

Binary data 11-8 
Central memory 11-9 
Octal lines 11-8 

Loading (also see CYBER Loader) Central 
memory 1-6 
LOC commeuid 11-8 
Local applications 7-32 
Local batch job 3-6.2 
Local file 2-12; C-8 
Creation 2-12,13 
Local file name C-8 
Local file name table (FTN) C-8 
Local file type 2-11 
LOCK command 9-26 
Locked file C-8 
Lockout of messages J-20 
Logical device 2-6; C-8 

Logical identifier of mainframe (LID) 

7-36; C-8 

Logical line 16-3; K-1 
Logical record C-8 
Logical track 2-6 
Login 3-2,5; 8-28; C-8 
LOGIN ccmimand 8-28 
Logout 3-4,5; 8-21,29; C-8 
LOGODT command 3-4; 8-29 

Logout display 3-4; 8-20 

Loopback 7-38 

Loosely coupled network (LCN) C-8 
L072 command 9-27 
LVL function 6-16 


HA (See Monitor address) 

MACHINE command 7-39 
Machine identifier 3-19; 6-8.1; D-4 
Macro C-8 
Magnetic tape 1-4 

ANSI labels 12-2,9 
ANSI steuidard labeled 2-8.1,9 
Assignment 12-1,5,21 
AT 2-8 

Blank label 12-9 
Block size 12-14 
Block terminator 2-10 
Cartridge 2-8 
Checl^oint dump 13-2 

Checkpoint file 12-8,14.1 

Code set A-12 


Command rules 12-2 
Conversion mode for NT, CT, AT 
tapes 12-8,10.1,14 
Copying 2-7 
Creating files 12-5 
CT 2-8 

Data formats 2-5,9; I-l 
Density 2-8.1; 7-54; 12-6.1,13 
Density specification 12-2 
Device type 12-6 
Error processing 12-3 
Error recovery 2-10 
Expiration date 12-16 
File accessibility character 
12-10.1,10.2,15 
File positioning 12-11 
File sequence nvunber 12-15 
File set configurations 2-8.1 
Generation number 12-15 
Generation version number 12-16 
Label 2-8.1; 12-9,11; G-1 
licLbel steuidard level 12-10.2 
Lcd>el verification 12-11 
Labeled 9-59,64; 12-7,14,21 
Load point 12-2 
Maximum block size 9-62 
MT 2-8 

Multifile set 2-9; 12-11,15 
Ifeiltivolume set 12-25 
Noise block 9-62 
Noise size 12-8,14 
Nonstandard labeled 2-8.1 
NT 2-8 

Obsolete tape formats I-l 
Overwriting laOsels 12-11 
Parity 2-8,8.1,10 
Parity Error 12-3 
Physical file structure 2-5 
Processing option 12-3 
Read-only protection 12-4 
Recording mode 2-7 

Section number 12-15 

Security access level 12-18.1 
Set identifier 12-15 
Tape mark 2-8.1 
Trailer sequence 12-4 
Uhlabeled 9-4; 12-7,14 
Unloading 12-5 
Verification 12-11 
Volume name 12-25 
Write-enable enforcement 12-5 
Write ring 12-4 
7-track 2-8.1 
9 -track 2-8.1 

Magnetic tape activity 3-18 
Magnetic tape file 9-43 
Mauiual references 7 
HAP (See Matrix Array Processor) 

Mass storage C-9 
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Hass storage activity 3-18; D-4 
Hass storage, Alternate 2-15,16 
Mass storage device 1-4; 2-15; N-l 
Mass storage file 2-6 
Master device C-9 
Master user 14-11,12 
Matrix Array Processor (MAP) 3-8 
Resource usage 3-18 
MAXFL (See Field length, maximum) 

Memory) 

MERGE file 14-16 

Message Control System (MCS) 3-6; 7-32; 
8-18 

Message delimiters K-2 
Message lockout, operator J-20 
Message to network operator J-21 
Message transmission key J-12,13; K-1,2 
MFI, command 7-39 
MFLINK 

Directives 10-23 
Interactive use 10-27 
MFLINK command 3-6,6.1; 10-22 
HFQUEUE 

Directive prefix character 9-31 
Routing directive 9-33 
MFQUEUK command 3-6,6.1; 9-31 
Microconputer file transfers P-1 
MODE command 6-22 
Mode 4 terminals J-4 
Modification symbols 7-50.1 
MODIFY command 14-5 
MODIFY mode 10-8 
MODIFY utility 14-8 
MOVE commcUid 8-48 
MS ccmonand J-21 
Multifile file 2-3,4; C-9 
Multifile set C-9 

Multimainframe configuration 1-3; 2-15 

M33 teletype 16-1; J-25 

M35 teletype 16-1; J-25 

M37 teletype 16-1; J-25 

M38 teletype 16-1; J-25 

M40 terminal 16-1; J-25 


NAM (See Network Access Method) 

NAM/CCP network canmands 8-26 

NAME directive 15-31 

NDL (See Network Definition Language) 

Network 16-1; C-9; J-1 

Applications 3-6; 7-32 
Configurations 7-36 
Processing modes 1-1 
Network access device 1-5 
Network Access Method (NAM) l-l; 7-38 

Network control character J-10,21 
Network Definition Language (NDL) J-2,24 
Network Job Entry Facility (NJF) 7-32; 8-18 


Network operator (NOP) C-9 

Network Operator Utility (NETOD) 7-32; 8-18 

Network processing unit (NPD) 1-5 
Network type 6-8.1 
NETOO (See Network (Operator Utility) 

NEW command 9-34 
NEW directive 15-28 
NEWPL file 14-16 

NJF (See Network Job Entry Facility) 

No abort option 10-3 

No-auto-drpp status (ND) 8-27; 9-56 

.NOCLR directive 4-31 

NOEKIT commauid 3-12; 5-7; 6-24 

NOINS directive 15-28 

Noise C-9 

Noise size 12-8,14 

Nonallocatable device C-9 

NOP (See Network operator) 

NOREP directive 15-29 

NORERUN command 7-40 

NOREW directive 15-29 

Normal mode 8-2,4,7; A-3; E-1 

NORMAL mode 8-4; A-3 

Normalized input mode J-18; K-1 

NOS/VE dual-state system 3-6 

NOS/VE Interactive Facility (VEIAF) 7-32; 

8-18 

NOSORT command 8-29 
NOSTEXT file 14-4 

NOTE command 7-40 

.NOTE directive 4-31 
NPC= entry point 5-2; 15-43 

NULL command 8-15 
Numeric string 6-5 
NUH fxmction 6-16.1 


Object code C-9 

OC command J-21 

OFFSW command 7-41 

OLD command 10-28 

OLD directive 15-29 

OLDPL file 14-17 

ONEXIT command 5-7; 6-24 

Online manuals 8-20.1,26 

ONSW command 7-42 

OP command J-21 

Operand overflow error 6-23 

Operauid underflow error 6-23 

Operands 6-5 

Operating system level 6-7 

Operating system value 6-11 

Operating system version D-2 

OPL file 14-4 

OPL record type 15-3,6,15 

OPLC record type 15-3,6,15 

OPLD directory 15-24,33 

OPLD record type 15-3,6,13 

OPLEDIT comnand 14-8 
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Origin type C-9 
OOT ccxnmand 9-35 
Output 

Cards pxmched 3-19 
Data E-2 

Device selection J-21 
Flow control J-21 
Lines printed 3-19 
Listing identification 2-2 
Print file code conversion A-3 
Printed H-1 
Processing 2-12; 7-S2 
Queued job 2-12 
Remote batch 2-12 
Sij^ression of headers 8-4 
Suspension 16-5,7 

ODTPOT file 2-11; 3-19; 7-68; 9-44,45 
Output line 

Aborting 16-5 
Length 16-3 
OVCAP record type 15-4 
OVL record type 15-3 

OVWRITE command 9-35 


PA conmand J-22 
PACK command 9-36 
Pack name 10-3,29 

Packet-switching network (PSH) 16-1; C-9 

PACKNAM command 10-29 

Page boundary 16-5 

Page density 6-7 

• PAGE directive 4-32 

Page length 6-7; J-23 

Page size 6-7 

Page wait 16-5; J-23 

Page width 6-7; J-24 

Panel conpilation 14-10 

Panel definition file 14-10 

Panel, full screen C-9 

PANELIB 8-36 

Paper length, line printer H-1 
Paper size, line printer H-1 
Paper tape 

Control cheiracters M-2 
Corrections M-4 
Input lines H-2 
Operation M-l 
Punch M-1 

Punching off-line M-3 
Punching online H-4 
Reader M-i 
Parameter C-9 
Keyword 5-4 
Order-dependent 5-4 
Order-independent 5-4 

Parity C-10 

Magnetic tape 2-8,10 


Parity processing j-22 
Passive procedure 4-1; C-10; L-1 
PASSWOR ccznmand 7-42 
Password C-10 
Batch 7-42 
Changing 7-42 
Entry 7-74 
Interactive 7-42 
Pause bit 7-22,44 
PAUSE ccnim 2 Uid 7-44 
PBC comnmnd 11-9 

PDU command 14-10 

PE tape density 7-54 
Peripheral equipment 1-4,5 
Peripheral processor library 5-5 
Peripheral processor (PP) 1-4; C-10 
Permanent file 2-13,14; 10-10,15,45,46; 

C-10 

Permanent file activity 3-18; D-4 

Penncuient file catalog 2-12 

Permament file device C-10 

Permanent file family C-10 

Permit category 10-3 

PERMIT ccxnmand 10-30 

Personal identifier 3-3,13 

PFC aurray, 580 line printer 9-48.2; H-1,6 

PFC printer H-1 

PFC (See Programmable format control) 

PG commauad J-23 
Physical line 16-3; K-1 
Physical mainframe identifier (PID) 7-36 
Physical record unit (PRU) 2-4; C-10; N-1 
PID (See Physical identifier of mainframe) 
PL command J-23 

PLATO - NAM Interface (PLATO) 7-32; 8-18 

Plot disposition 2-11; 9-45 

Post radix C-10 

POST terminal J-1 

PP record type 15-3 

PP (See Peripheral processor) 

PPD record type 15-3 
Prefix cdiaracter, command 5-2 
$ Prefix, command 5-2 
Prefix tad3le 15-25 
Prefix table, record 15-2,35 
PRIMARY command 9-37 
Primary file 2-13; C-10 
Chauiging lines 8-42 
Creation 9-34 
Editing 8-1,39 
Inserting lines 8-42 
Line number overlap 8-41 
Type 2-11 

#PRIMARY value 4-14; L-1 

Print density H-1,7 

Print disposition 2-11; 9-44 

Print trains A-3 

Printer carriage control H-1 
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Printer Support Utility (PSU) 7-32; 8-18 

Printing files 9-46 

Priority, job 3-9 

Priority, scheduling 3-7 

Private axuciliary device C-10 

Private file 10-3 

Privileged network applications 7-32 
• PRCX: directive 4-2 

Interactive format 4-11 
Menu format 4-22 
Passive format L-1 
PROC record type 15-3 
Procedure C-10 

Branching directives 4-38 
Call 4-41 

Checklist entries 4-13 
Checklist patterns 4-14,15,16 
Command record 4-4 
Ccmonand section 4-3 
Concatenation character 4-8 
Data section 4-3,6,34.2 
#DATA value 4-14 

Default termination sequence 4-51 
Directive syntax 4-9 
Directives 4-2 

Expansion control directives 4-33 
Bxpans ion proces s ing 4-4,8 

File directives 4-34.1 
File search order 4-42 
#FILE value 4-14 

Formatting and Help directives 4-23 
Formatting section 4-2 
Help section 4-2 
Inhibit character 4-6,7 
Interactive help processing 4-25 

Interactive parameter entry 4-4 

Interactive parameter format 4-12 
Interactive directives 4-40 
Menu 4-22 

Menu help processing 4-25 
Nesting level 4-1,14; 6-9 
Noninteractive 4-1; L-1 
Order-dependent parcuneter processing 
4-53 

Order-independent parcuneter processing 
4-53 

Parameter matching modes 4-53; L-2 
Parameter sixbstitution L-2 
Passive L-1 
ttPRIMARY value 4-14 
Processing 4-3 

Programmable function keys 4-24.2 
Prologrue (See Prologue) 

Requesting help 4-46 
Special parameter values 4-14 
Structure 4-2 
Termination 4-41,47,51 
Procedure file C-ll 
Residence 4-2 


Search order 4-42 
Procedure header directive 4-2 
Interactive format 4-11 
Interactive parameter format 4-12 
Menu format 4-22 
PROFILC file 14-11 
PROFILE command 14-11 
PROFILE directives 14-12 
Program library 2-17; 14-5,14 
Programmable format control (PFC) 

9-48.2; H-1 

Programmable function keys 4-24.1 

Project number 7-4 

Project profile file 14-11 

Prologue 7-4,30,31,73; C-ll 

Prologue, project C-ll 

.PROMPT directive 4-32 

PROTECT command 7-44 

Protected command 3-13 

PRD device C-ll 

PRD (See Physical record unit) 

PSN (See Packet-switching network) 

PSR level 6-16 

PSD (See Printer Support Utility) 

Public auxiliary device C-ll 

Public file 10-4 

Punch disposition 2-11; 9-45 

PONCH file 2-11; 3-19; 9-45; F-5,6 

PDNCHB file 2-11; 3-19; 9-45; 11-9; F-6 

PDRGALL consnand 10-31 

PURGE commamd 10-32.1 

PW commemd J- 24 

P8 file 2-11; 3-19; 9-45; F-7 


QGET command 7-45 

QTF (See Queued File Transfer Facility) 
Queue priority C-ll 

Queued file 2-11; 7-45; 9-31,35,44; C-ll 
Queued File Transfer Facility (QTF) 3-6 
Queued job output 2-12 
QUEUE7 command 7-46 


RA (See Reference address) 

Random access 15-1,2; C-ll 
Random access directory 15-11,17 
Random access file C-ll 
RBF (See Remote Batch Facility) 

RBR command 11-9 

RC command J-24 
READ command 8-49 
READ mode 10-8.1 

Read-only permission C-ll 
READAP mode 10-8 

READMD mode 10-8 

READDP mode 10-8 
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Real-time clock 7-58 

RKCLAIH command 10-33 

Database 10-33 
Directive cations 10-39 
Directives 10-36 
Format 10-35 
Output listing 10-44 
Record C-11 

Checksum 15-6,15 
Canments field 15-6,15 
Copying 15-7 
Creation date 15-6,15 
File subdivision 2-3 
Length 15-6,15 
Name 15-15 
Prefix table 15-2,25 
S-type 15-1 
Type 2-3; 15-3,15,16 
0-type 15-1 

Record groi^ identifier (GID) 15-21 
Record splitting 9-9,10 
Recording mode 
Binary 2-7 
Coded 2-7 

RECORDING MODE IS BINARY statement, COBOL 
2-7 

RECORDING MODE IS CODED statement, COBOL 
2-7 

Records, relocatcible 15-7 
RECOVER command 8-30 
Recoverable jobs 3-3; 8-30 
Recovery C-11 
Recovery processing 8-30,32 
REDO command 7-50 
Reel number G-2 
Reference address (RA) 1-2 
Reference address (RA and RAE) C-11 
Reference record identifier (RID) 15-21 
Reformatting directives 7-69 
REL record type 15-3,6,15 
Related publications 7 

Releasing file space 9-22 

Releasing files 9-5,42,56,64 
Relocatable records 15-7 
Remote Batch Facility (RBF) 1-1; 3-1,6; 
7-32; 8-18 

Remote batch job 3-6.2; 9-50 
Remote host 7-36; 9-31; C-12 
Remote Host Facility (RHF) 7-38; C-12 
Removable packs 7-57 
RENAME coDsnand 9-37 
RENAME directive 15-29 
REPLACE conmand 10-45 
REPLACE directive 15-30 
Replacing files 10-45 

REQUEST command 9-38; 12-21 

RERUN command 7-50.1 

RESEQ command 9-40 

Reservation block 2-7 
Reserved format chaumels for VFD 
processing H-9 


RBSOURC command 7-50.1,55 

Resource demand 7-14,51,54,56; 9-42 

Resource limits 7-29 

Resource overcommitment 7-55 

Resource usage 7-16.1,59,64,67; D-4 

Resource usage, record of 3-18 

Restart 13-1,2 

RESTART command 13-2 

RETURN command 7-54; 9-42 

REVERT comncmd 4-41,51 

REWIND command ~9-43 

REWIND directive 15-30 

Rewinding files 9-43 

RFL commcuid 7-40,57 

RFL= entry point 15-43 

RFL (See Running field length) 

RID (See Reference record identifier) 

Rolled out C-12 

ROLLOUT command 7-58 

Rollout control 3-12 

ROUTE command 3-6,6.1; 9-44 

Routing files 9-31,44 

RTIME command 5-5; 7-58 

Rubout M-2 

Rubout characters C-12 

RUN command 8-35 

Running field length (RFL) 3-9; 7-40 


S tape format 2-7,10; 9-10; 12-2 

S-type record 15-1 

SABRE C-12 

Satellite cotipler 1-5 

SAVE command 10-46 

Scheduler 3-9; 7-58 

Scheduling priority 2-12; 3-6.2,7,9; C-12 

SCOPE 2 Operating System 3-7; 7-46; 8-22 

SCOPE 2 Station Facility (SSF) 7-38 

SCOPY command 9-51 

Scratch files 2-1 

SCREEN ccxnmand 8-7 

Screen formatting 8-36; 14-10 

Screen mode 8-7; C-12 

Scrolling mode 8-6.1 

SDHs entry point 15-43 

SE commeuid J-24 

SECHDR comaumd 9-54 

Secure login command 8-36 

Secured mode 3-13 

Secured system 9-55; 10-48,49; C-12 
Security access categories 10-48 
Security access level 7-33,61; 9-3,55; 

10-2,49; 12-8.1; C-1 
Security administrator C-12 
Security count C-12 

Security features 3-13; 8-36; 9-54,55; 
10-48,49 

Security permissions 7-33 
Security unlock status C-12 
Semi-private file 10-4 
Sense switch 6-12; 7-41,42,73 
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Separator, canmand 5-2 
Sequence number C-12; G-4,8,9 
Sequential access 15-1; C-12 
Sequential (SQ) file C-12 
Service class 2-12; 3-6.2,7; 

7-5,7,18,23,33; C-13; D-2 
SET ccxnmauid 6-25 
.SET directive 4-34 
Set identification G-4,8,9 
Set identifier 12-15 

SETASL conmand 7-59 

SETCORE consnand 7-60 
SETFAL command 9-55 
SETFS ccmimand 9-56 
SETJAL conmeuid 7-61 

SETJOB ccmimand 7-62 

SETJSIi command 7-63 

SETPFAC cominsuid 10-48 
SETPFAL ccannand 10-49 
SETPR ccmimand 7-64 

SETTL ccmmiand 7-64 

SHELI, ccmimand 7-66 

SHELL permissions 7-32 
Shell program 7-66 

Short PRO C-13 
SHOW command 8-36 
SI format tapes 2-10; 9-10,59 
SKIP ccmimand 6-30 
SKIPEI command 9-56 
SKIPF ccmmiand 9-57 
SKIPFB command 9-57 
Skipping ccmimands 6-17,18,19 
SKIPR ccmimand 9-58 

Software, system 1-5 
Solid State Disk C-13 
SORT command 9-58 
Sort flag 8-29 
Sorting files 8-29; 9-40,58 
Source code C-13 

Special editing mode 8-2; C-13; J-24 
SRO (See System resource unit) 

Stack purging 7-39 

Standard labeled tape C-13 
STIME cranmand 5-5; 7-67 
Store and forward 7-38 
Storing files 10-45,46 
STR function 6-16.1 
STRB function 6-16.2 

STRD function 6-16.3 

String C-13 
SDBHIT ccmimand 7-68 
Directives 7-68 
Transparent submit mcsde 7-68 
Submit file 7-68 
Subsystem 6-7; 8-11; 10-5 
Subsystem, default 8-15 
Subsystem flag C-13 
Subsystem selection ccmimands 8-1,11 
SWITCH command 7-73 


Symbolic names. Flow control ccmnmand 

6- 7,25 

Syncdurcsnous terminal cmtput 16-5 
SYSBDIT, SC directive 5-2 
System access category set C-13 
System access level C-13 
System code G-4,8,9 
System error codes 6-9,10 
System file C-13 
SYSTEM file 10-16 
System library 5-'2; 10-16; 15-43 

System monitor 1-3 

System origin job 3-6.2 
System prologue 7-30 
System resource unit (SRD) 3-8; 

7- 59,64,67; C-13; D-4 
Limit 3-11 
Resource usage 3-18 

System resource usage 7-16.1 
System resources, accounting of 3-8; 7-4 
System secnirity features 3-13; 8-36 
System symbols, cross reference listing 14-4 
System text 14-4 
SYSTEXT file 14-5 


TAF (See Trouisaction Facility) 

Tape assignment 12-5,21 

Tape density 7-54 

Ta^e density identifier 7-54 

Tape format C-13 

Tape formats 2-7,10; 12-13; I-l 

Tape formats, obsolete I-l 

Tape management 12-1 

Tape mark C-13 

Tape marks 2-8.1; 12-2 

Tcq>e owner identification G-2 

Ta^e (See also Magnetic tape) 

Tape Verification Facility (TVF) 3-6 

TAPEn file 11-10 

TC ccmimand J-2,25 

TCOPY command 2-7; 9-59 

TDD ccxnmamd 8-8.1 

TDDMP ccmmicuid 9-62 

Tek terminal J-l 

Tektronix 4010/4014 terminal 16-1; J-25 
Teletypewriter (TTY) 16-1; J-l 
Televideo terminals 8-6.2,8; 16-1 
Teiqporary file C-13 
Terminal 

Categories J-4 
Character conversion E-1 
Characteristics 8-9; J-l 
Classes 16-1; J-l,24,25 
Control 16-9 
Definition ccmmauids 16-2 
Display of characteristics J-8 
Ii^ut/output conventions 16-2 
Name C-13 
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Output 16-5 
Session 3-3 

Terminal attributes 8-9 
Terminal character set-mode 6-6 
Terminal characteristics 3-5; J-l 
Terminal characteristics, CCP default J-2 
Terminal characteristics, NDL default 
J-2,24 

Terminal classes J-1 
Terminal control commands 8-2 
Terminal definition commands 16-4; J-1 
Terminal definition file 8-6.1,7,8.1 
Terminal display mode 6-8.1 
Terminal identifier (TID) 2-12 
Terminal messages 7-40 
Terminal output 

Asynchronous 16-5 
Synchronous 16-5 

Terminal Verification Facility (TVF) 7-32; 
8-18 

Terminating a host-terminal connection J-26 

Terminating input lines 16-3 

Termination character 16-6; J-8 

Termination sequence 16-4,6; C-14; J-8 

Terminator, command 5-2,3 

TERMLIB 8-6.1,7,8.1 

TEXT command 8-37 

Text editor facility 14-1 

Text editors 14-1,18 

Text mode 8-37 

TEXT record type 15-3 

TID (See Terminal identifier) 

Tieline Facility (TLF) 7-32; 8-18 

Time of the week 6-7 

Time slice C-14 

Timed/Event rollout C-14 

TIHEOUT ccmimand 8-9 

Timeout period 3-5 

Timeout status 8-9 

TLF (See Tieline Facility) 

TM command J-26 
Tracks 2-8 

Transaction Facility (TAF) l-l; 3-6; 7-32; 
8-18 

Transferring files between mainframes 
9-31,49,50; 10-22 
Transmission key K-1 
Transmitting input K-l 

Transparent input mode C-14; J-11,18,27; 

K-l 

Transparent submit mode 7-68,70; C-14 
TRMDEF ccaanand 8-9; 16-2; J-2 
TTY (See Teletypewriter) 

TVF (See Tape verification facility) 

TVF (See Terminal Verification Facility) 

TYPE directive 15-30 
Type of network 6-8.1 


n-type record 15-1 

DCF record type 15-4 

UCLP (See Output, Lines printed) 

DCLV (See Output, Lines printed) 

DCPC (See Output, Cards punched) 

DEAC (See implication. Job usage) 

DEAD (See Adder activity) 

DECP (See Accimiulated central processor time) 
DEHS (See Hass storage activity) 

DEMT (See Magnetic tape activity) 

DEPF (See Permanent file activity) 

DHLa G-11 

DHLa label 6-1 

DJN (See Dser job name) 

DLIB commcuid 15-34 

DLIB directory 15-32,33 

DLIB record type 15-3,6 

Dnlabeled tape 12-7,14 

DNIXJAD command 7-54; 9-64 

DMLOCK ccxnmand 9-65 

DPDATE ccmnnand 14-14 

DPDATE mode 10-8 

DPL record type 15-15 

DPLx record type 15-4 

DPROC command 7-73 

DS code A-3 

DSECPD command 7-74 

Dser break processing 16-4 

Dser break 1 16-6; C-14; J-6,7 

Dser break 2 16-6; C-14; J-8 

DSER command 7-69,74 

Dser header label G-1 

Dser index 7-30; C-14 

Dser index hash 3-8; 7-14; C-14; D-2 

Dser job name (DJN) 3-8; 7-18,23,62; 

C-14; D-2 
Dser label G-11 

Dser library 2-17; 15-1,32,33,34,43 

Dser neuae 2-14; C-14 

Dser name, alternate 10-5 

Dser name LIBRARY 8-22,26 

Dser number C-14 

Dser permissions 7-31 

Dser program 1-5 

Dser prologue (See Prologue) 

Dser trailer label G-1 

Dser validation 3-8; 7-28,74 

Dser validation limits 7-5 

Dser volume label G-1 

Dsing XMODEM P-1 

DT terminal J-1 

DTLa G-11 

DTZ,a label G-1 

DVLa G-11 

DVLa label G-1 
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Validation file C-14 

Validation limits 7-28 

VEIAF (See NOS/VE Interactive Facility) 

VERIFY command 9-65 

Verifying files 9-65; 15-35 

VFD load procedinre H-2,4.2 

VFYIjIB command 15-3,35 

VFYLIB directive 15-31 

Voltune C-14 

Volume accessibility chcoracter, tape 12-10.1 
Volume header label 6-1,2 
Volume serial number (VSN) 12-1,6,11,25; 
C-15; G-2 

VOLl label 2-8.1,9; 12-1,9; G-1,2 

VSN command 12-25 

VSN (See Volume serial number) 


Wait disposition 2-11,12; 9-45 

Wait-if-busy option 10-6 

WBR ccmimand 11-10 

Weekday 6-7 

WHATJSN comnand 8-37 

WHILE ccmmamd 6-31 

.WHILE directive 4-40.1 

Word C-15 

WRITE command 8-51 

Write interlock 2-15; 9-26,65; C-15 

WRITE mode 10-8.1 

Write ring C-15 

WRITER command 9-68 

WRITEN command 8-52 

WRITER command 9-68 


X command 8-38 

X format 1-3 

X format tapes 9-59 

X.25 Piiblic data network 7-36,38 

X.25 terminals J-4 

XEDIT cranmand 14-18 

XL command J-27 

XMODEM command 8-38; P-1 

X3.64 terminal J-1 


YANK status 15-6,15 


Zero byte terminator C-15 
Zero length PRO C-15 
ZZZDDMP file 3-12; 11-5,6,7 

ZZZZDMB file 11-1,3 

ZZZZTRM 8-6.1,7 
ZZZZZLD file 13-1 
ZZZZZxx files 13-1 

026 punch code A-3; F-3 
029 punch code A-3; F-3 


5/7/9 multipunch F-3,5 

6- bit display code 8-2; 9-23 
6/12-bit display code 8-2; 9-23 
6/7/8/9 multipvinch 2-6; C-15; P-2 
6/7/9 multipunch 2-6; C-15; F-2 
6PP record type 15-4 

7- bit ASCII code 9-23; A-1 

7/8/9 multipunch 2-6; 3-1; C-15; F-2 
7/9 multipunch F-5 
7PP record type 15-4 

63- character set A-1 

64- character set A-1 

77 table (see Prefix table, record) 15-2 
95-character set A-1 
533/536 printer 9-48; A-4; H-1,2,4 

580 line printer 

Cairriage control array H-7 
Format controls H-1 
PPC array H-1 
Spacing code 9-48.2 
585 line printer 9-48; H-l,2 
711-10 terminal 16-1; J-25 

713- 10 terminal 16-1; J-25 

714- 10/20 terminal 16-1; J-25 

714-30 terminal 16-1; J-25 

721 terminal 16-1; J-25 

722-30 terminal 16-1; J-25 

722 terminal 16-1; J-25 

731- 12 terminal 16-1; J-25 

732- 12 terminal 16-1; J-25 

734 terminal 16-1; J-25 
751-1 terminal 16-1; J-25 
752 terminal 16-1; J-25 

756 terminal 16-1; J-25 

1200 User Terminal 16-1; J-25 
2741 terminal, ATTN key 16-8 

5870 Non Inpact Printer 9-44; H-1 

7700 table (see Prefix table, record) 

15-2 9-54,55; 10-48,49 


Index-16 


60459680 P 




